captions

Changed on

Retrieves a list of resources, possibly filtered.

get/youtube/v3/captions

Request

  • Base URL: https://youtube.googleapis.com
  • URL: https://youtube.googleapis.com/youtube/v3/captions
  • Auth: one of:
    • 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/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

partstring[] required

The part parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.

videoIdstring required

Returns the captions for the specified video.

idstring[]

Returns the captions with the given IDs for Stubby or Apiary.

onBehalfOfstring

ID of the Google+ Page for the channel that the request is on behalf of.

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.force-ssl was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtube.force-ssl 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.force-ssl was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/youtube.force-ssl 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