Google Ads Media API

The Media API from Google Ads — 1 operation(s) for media.

GitHub OpenAPI

Operations 1

POST /v26/customers/{customersId}/youTubeVideoUploads:create Upload media #

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-ads:google-ads-media-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-ads-media-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Google Ads Media API
  version: v26
  description: Generated from Google's published Discovery document for Google Ads API (googleads v26, revision 20261110). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://googleads.googleapis.com
tags:
- name: Media
paths:
  /v26/customers/{customersId}/youTubeVideoUploads:create:
    post:
      operationId: googleads.media.upload
      summary: Upload media
      description: Uploads a video to Google-managed or advertiser owned (brand) YouTube channel.
      parameters:
      - name: customersId
        in: path
        required: true
        description: Resource name segment (customersId).
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleAdsGoogleadsV26Services__CreateYouTubeVideoUploadRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleAdsGoogleadsV26Services__CreateYouTubeVideoUploadResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/adwords
      - apiKey: []
      x-google-media-upload:
        protocols:
          resumable:
            multipart: true
            path: /resumable/upload/v26/customers/{+customerId}/youTubeVideoUploads:create
          simple:
            multipart: true
            path: /upload/v26/customers/{+customerId}/youTubeVideoUploads:create
        accept:
        - '*/*'
        maxSize: '5368709120'
      tags:
      - Media
components:
  schemas:
    GoogleAdsGoogleadsV26Resources__VideoContentMetadata:
      type: object
      properties:
        generativeContentDisclosure:
          type: string
          description: Input only. Immutable. Advertiser provided disclosure for generative content.
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - NON_GENERATIVE_CONTENT
          - GENERATIVE_CONTENT
      description: Video content metadata.
    GoogleAdsGoogleadsV26Services__CreateYouTubeVideoUploadResponse:
      type: object
      description: Response message for YouTubeVideoUploadService.CreateYouTubeVideoUpload.
      properties:
        resourceName:
          type: string
          description: The resource name of the successfully created YouTube video upload.
    GoogleAdsGoogleadsV26Services__CreateYouTubeVideoUploadRequest:
      properties:
        youTubeVideoUpload:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV26Resources__YouTubeVideoUpload'
          description: Required. The initial details of the video to upload. Required.
      description: Request message for YouTubeVideoUploadService.CreateYouTubeVideoUpload.
      type: object
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    GoogleAdsGoogleadsV26Resources__YouTubeVideoUpload:
      properties:
        videoUploadId:
          description: Output only. The unique ID of the YouTube video upload.
          readOnly: true
          format: int64
          type: string
        channelId:
          description: Immutable. The destination YouTube channel ID for the video upload. Only mutable on YouTube video upload creation. If omitted, the video will be uploaded to the Google-managed YouTube channel associated with the Ads account.
          type: string
        videoTitle:
          type: string
          description: 'Input only. Immutable. The title of the video. The video title is required, must not exceed 100 characters, and must not contain invalid characters. It can be modified when creating the YouTube video upload, but is immutable after creation. See the YouTube Help Center for more information: https://support.google.com/youtube/answer/57407'
        videoId:
          readOnly: true
          type: string
          description: Output only. The YouTube video ID of the uploaded video.
        videoContentMetadata:
          $ref: '#/components/schemas/GoogleAdsGoogleadsV26Resources__VideoContentMetadata'
          description: Input only. Immutable. The video content metadata. Only mutable on YouTube video upload creation. Immutable after creation.
        videoDescription:
          type: string
          description: 'Input only. Immutable. The description of the video. The video description must not exceed 5000 characters and must not contain invalid characters. It can be modified when creating the YouTube video upload, but is immutable after creation. See the YouTube Help Center for more information: https://support.google.com/youtube/answer/57407'
        resourceName:
          type: string
          description: Immutable. Resource name of the YouTube video upload.
        videoPrivacy:
          description: The privacy state of the video. Only mutable for videos uploaded to the advertiser owned (brand) YouTube channel. For videos uploaded to the Google-managed channels only UNLISTED privacy is allowed. Defaults to UNLISTED privacy if not specified.
          type: string
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - PUBLIC
          - UNLISTED
        state:
          enum:
          - UNSPECIFIED
          - UNKNOWN
          - PENDING
          - UPLOADED
          - PROCESSED
          - FAILED
          - REJECTED
          - UNAVAILABLE
          readOnly: true
          type: string
          description: Output only. The current state of the YouTube video upload.
      description: Represents a video upload to YouTube using the Google Ads API.
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/adwords: See, edit, create, and delete your Google Ads accounts and data.
externalDocs:
  url: https://developers.google.com/google-ads/api/
x-provenance:
  method: harvested
  publisher: Google
  source: https://googleads.googleapis.com/$discovery/rest?version=v26
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)