# YouTube Data API v3 . channelBanners

## Instance Methods

Inserts a new resource into this collection.

### Method Details

`insert(body=None, onBehalfOfContentOwner=None, channelId=None, onBehalfOfContentOwnerChannel=None, x__xgafv=None, media_body=None, media_mime_type=None)`

    Inserts a new resource into this collection.

    Args:
      body: object, The request body.
        The object takes the form of:

    { # A channel banner returned as the response to a channel_banner.insert call.
        "etag": "A String",
        "kind": "youtube#channelBannerResource", # Identifies what kind of resource this is. Value: the fixed string
            # <code>"youtube#channelBannerResource"</code>.
        "url": "A String", # The URL of this banner image.
      }

      onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube
    content partners.<br><br>The
    <code><strong>onBehalfOfContentOwner</strong></code> parameter indicates
    that the request's authorization credentials identify a YouTube CMS user
    who is acting on behalf of the content owner specified in the parameter
    value. This parameter is intended for YouTube content partners that own and
    manage many different YouTube channels. It allows content owners to
    authenticate once and get access to all their video and channel data,
    without having to provide authentication credentials for each individual
    channel. The actual CMS account that the user authenticates with must be
    linked to the specified YouTube content owner.
      channelId: string, Unused, channel_id is currently derived from the security context of the
    requestor.
      onBehalfOfContentOwnerChannel: string, This parameter can only be used in a properly <a
    href="/youtube/v3/guides/authentication">authorized request</a>.
    <strong>Note:</strong> This parameter is intended exclusively for YouTube
    content partners.<br><br>The
    <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter
    specifies the YouTube channel ID of the channel to which a video is being
    added. This parameter is required when a request specifies a value for the
    <code>onBehalfOfContentOwner</code> parameter, and it can only be used in
    conjunction with that parameter. In addition, the request must be
    authorized using a CMS account that is linked to the content owner that the
    <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the
    channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value
    specifies must be linked to the content owner that the
    <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This
    parameter is intended for YouTube content partners that own and manage many
    different YouTube channels. It allows content owners to authenticate once
    and perform actions on behalf of the channel specified in the parameter
    value, without having to provide authentication credentials for each
    separate channel.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format
      media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
      media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.

    Returns:
      An object of the form:

        { # A channel banner returned as the response to a channel_banner.insert call.
          "etag": "A String",
          "kind": "youtube#channelBannerResource", # Identifies what kind of resource this is. Value: the fixed string
              # <code>"youtube#channelBannerResource"</code>.
          "url": "A String", # The URL of this banner image.
        }