thumbnails

Changed on

As this is not an insert in a strict sense (it supports uploading/setting of a thumbnail for multiple videos, which doesn't result in creation of a single resource), I use a custom verb here.

post/youtube/v3/thumbnails/set

Request

  • Base URL: https://youtube.googleapis.com
  • URL: https://youtube.googleapis.com/youtube/v3/thumbnails/set
  • Auth: one of:
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtube) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/youtube)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtube.force-ssl) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/youtube.force-ssl)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtube.upload) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/youtube.upload)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtubepartner) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/youtubepartner)

Query parameters

videoIdstring required

Returns the Thumbnail with the given video IDs for Stubby or Apiary.

onBehalfOfContentOwnerstring

Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner 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.

Response

Successful response

Changes

  • a62cce9a7aacRevision changes
    • info

      the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/youtubepartner was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtubepartner was removed from the endpoint's security scheme Oauth2c

  • 5f5aee36c620Revision changes
    • breaking

      removed the media type */* for the response with the status

    • info

      the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/youtubepartner was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtubepartner was removed from the endpoint's security scheme Oauth2c