Display & Video 360 API (displayvideo:v4)

2025-10-24

11 new methods

Additions

    Methods
  • displayvideo.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.delete

      Parameter Order :

    • advertiserId
    • lineItemId
    • youtubeAssetType
    • youtubeAssetAssociationId
    • Flat Path : v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations/{youtubeAssetAssociationsId}

      Scopes : https://www.googleapis.com/auth/display-video

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Description : Required. The ID of the advertiser this request is for.

          Type : string

          Format : int64

          Location : path

          Required : Yes

        linkedEntity.adGroupId

          Format : int64

          Description : The unique ID of the ad group linked.

          Location : query

          Type : string

        lineItemId

          Format : int64

          Pattern : ^[^/]+$

          Location : path

          Required : Yes

          Description : The unique ID of the line item linked.

          Type : string

        youtubeAssetAssociationId

          Description : Required. The ID of the YouTube asset in the association. For location associations: This should be the ID of the asset set linked, or 0 if the association stands for location asset is disabled. For affiliate location associations: This should be the ID of the asset set linked, or 0 if the association stands for affiliate location asset is disabled. For sitelink associations: This should be the ID of the sitelink asset linked.

          Required : Yes

          Location : path

          Pattern : ^[^/]+$

          Type : string

          Format : int64

        youtubeAssetType

          Type : string

          Description : Required. The YouTube asset type this request is for.

          Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Required : Yes

          Pattern : ^[^/]+$

          Location : path

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK

      Description : Deletes an existing association between an entity (line item or ad group) and a YouTube asset.

      Path : v4/advertisers/{+advertiserId}/lineItems/{+lineItemId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations/{+youtubeAssetAssociationId}

      HTTP Method : DELETE

  • displayvideo.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.create

      Parameter Order :

    • advertiserId
    • lineItemId
    • youtubeAssetType
    • HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/display-video

      Description : Creates a new association between an entity (line item or ad group) and a YouTube asset. Returns the newly created association if successful.

      Parameters :

        lineItemId

          Type : string

          Location : path

          Format : int64

          Required : Yes

          Description : The unique ID of the line item linked.

          Pattern : ^[^/]+$

        advertiserId

          Description : Required. The ID of the advertiser this request is for.

          Pattern : ^[^/]+$

          Format : int64

          Location : path

          Required : Yes

          Type : string

        linkedEntity.adGroupId

          Location : query

          Type : string

          Description : The unique ID of the ad group linked.

          Format : int64

        youtubeAssetType

          Pattern : ^[^/]+$

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK
        • Type : string

          Required : Yes

          Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Location : path

          Description : Required. The type of the linked YouTube asset in the association.

      Path : v4/advertisers/{+advertiserId}/lineItems/{+lineItemId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations

      Flat Path : v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations

  • displayvideo.advertisers.lineItems.youtubeAssetTypes.youtubeAssetAssociations.list

      HTTP Method : GET

      Scopes : https://www.googleapis.com/auth/display-video

      Parameter Order :

    • advertiserId
    • lineItemId
    • youtubeAssetType
    • Path : v4/advertisers/{+advertiserId}/lineItems/{+lineItemId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations

      Description : Lists the YouTube asset associations for given resource.

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Description : Required. The ID of the advertiser this request is for.

          Location : path

          Required : Yes

          Format : int64

          Type : string

        orderBy

          Type : string

          Location : query

          Description : Optional. Field by which to sort the list. The only acceptable values are: `linkedYoutubeAsset.locationAssetFilter.assetSetId`, `linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId`, `linkedYoutubeAsset.sitelinkAsset.assetId` The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be added to the field name. Example: `linkedYoutubeAsset.sitelinkAsset.assetId desc`.

        pageToken

          Description : Optional. A token identifying a page of results the server should return.

          Type : string

          Location : query

        youtubeAssetType

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK
        • Pattern : ^[^/]+$

          Description : Required. The type of YouTube asset in the association.

          Required : Yes

          Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Location : path

          Type : string

        pageSize

          Location : query

          Description : Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`.

          Format : int32

          Type : integer

        linkedEntity.adGroupId

          Format : int64

          Location : query

          Type : string

          Description : The unique ID of the ad group linked.

        lineItemId

          Type : string

          Location : path

          Pattern : ^[^/]+$

          Format : int64

          Description : The unique ID of the line item linked.

          Required : Yes

      Flat Path : v4/advertisers/{advertisersId}/lineItems/{lineItemsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations

  • displayvideo.advertisers.adAssets.create

      Parameters :

        advertiserId

          Pattern : ^[^/]+$

          Type : string

          Location : path

          Description : Required. The ID of the advertiser this ad asset belongs to.

          Format : int64

          Required : Yes

      HTTP Method : POST

      Flat Path : v4/advertisers/{advertisersId}/adAssets

      Path : v4/advertisers/{+advertiserId}/adAssets

      Scopes : https://www.googleapis.com/auth/display-video

      Description : Create a video asset for Ad. Only supports youtube video assets for now.

      Parameter Order : advertiserId

  • displayvideo.advertisers.adAssets.get

      Scopes : https://www.googleapis.com/auth/display-video

      Parameters :

        adAssetId

          Type : string

          Required : Yes

          Format : int64

          Location : path

          Description : Required. The ID of the ad asset to fetch.

          Pattern : ^[^/]+$

        advertiserId

          Required : Yes

          Pattern : ^[^/]+$

          Description : Required. The ID of the advertiser this ad asset belongs to.

          Location : path

          Format : int64

          Type : string

      Description : Get an ad asset by ad asset ID. Only supports youtube video assets.

      HTTP Method : GET

      Path : v4/advertisers/{+advertiserId}/adAssets/{+adAssetId}

      Flat Path : v4/advertisers/{advertisersId}/adAssets/{adAssetsId}

      Parameter Order :

    • advertiserId
    • adAssetId
  • displayvideo.advertisers.adAssets.list

      Description : List ad assets by advertiser ID. Only supports youtube video ad assets.

      Parameters :

        advertiserId

          Type : string

          Required : Yes

          Location : path

          Description : Required. The ID of the advertiser to list assets for.

          Pattern : ^[^/]+$

          Format : int64

        pageToken

          Location : query

          Type : string

          Description : Optional. A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to `ListAssets` method. If not specified, the first page of results will be returned.

        pageSize

          Format : int32

          Description : Optional. Requested page size. Must be between `1` and `5000`. If unspecified will default to `5000`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.

          Location : query

          Type : integer

        orderBy

          Location : query

          Description : Optional. Field by which to sort the list. Acceptable values are: * `entityStatus` * `youtubeVideoAsset.youtubeVideoId` * `adAssetId` (default) The default sorting order is ascending. To specify descending order for a field, a suffix "desc" should be added to the field name. Example: `assetId desc`.

          Type : string

        filter

          Description : Optional. Filter expression to restrict the ad assets to return. The supported fields are: * `youtubeVideoAsset.youtubeVideoId` * `entityStatus` Examples: * `entityStatus=ENTITY_STATUS_ACTIVE`

          Location : query

          Type : string

      Path : v4/advertisers/{+advertiserId}/adAssets

      Scopes : https://www.googleapis.com/auth/display-video

      Parameter Order : advertiserId

      Flat Path : v4/advertisers/{advertisersId}/adAssets

      HTTP Method : GET

  • displayvideo.advertisers.adAssets.bulkCreate

      Path : v4/advertisers/{+advertiserId}/adAssets:bulkCreate

      Scopes : https://www.googleapis.com/auth/display-video

      Parameter Order : advertiserId

      Description : BulkCreate video assets for Ad. Only supports youtube video assets for now.

      Flat Path : v4/advertisers/{advertisersId}/adAssets:bulkCreate

      HTTP Method : POST

      Parameters :

        advertiserId

          Format : int64

          Description : Required. The ID of the advertiser this ad asset belongs to.

          Required : Yes

          Type : string

          Pattern : ^[^/]+$

          Location : path

  • displayvideo.advertisers.adAssets.upload

      Mediaupload :

        Accept : */*

        Protocols :

          Simple :

            Path : /upload/v4/advertisers/{+advertiserId}/adAssets:uploadAdAsset

            Multipart : Yes

      Description : Uploads an ad asset. Returns the ID of the newly uploaded ad asset if successful.

      Scopes : https://www.googleapis.com/auth/display-video

      HTTP Method : POST

      Parameters :

        advertiserId

          Location : path

          Type : string

          Required : Yes

          Pattern : ^[^/]+$

          Format : int64

          Description : Required. The ID of the advertiser this ad asset belongs to.

      Parameter Order : advertiserId

      Flat Path : v4/advertisers/{advertisersId}/adAssets:uploadAdAsset

      Path : v4/advertisers/{+advertiserId}/adAssets:uploadAdAsset

      Supportsmediaupload : Yes

  • displayvideo.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.list

      Flat Path : v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations

      Description : Lists the YouTube asset associations for given resource.

      Scopes : https://www.googleapis.com/auth/display-video

      HTTP Method : GET

      Parameter Order :

    • advertiserId
    • adGroupId
    • youtubeAssetType
    • Path : v4/advertisers/{+advertiserId}/adGroups/{+adGroupId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations

      Parameters :

        linkedEntity.lineItemId

          Format : int64

          Location : query

          Description : The unique ID of the line item linked.

          Type : string

        adGroupId

          Pattern : ^[^/]+$

          Type : string

          Location : path

          Description : The unique ID of the ad group linked.

          Format : int64

          Required : Yes

        advertiserId

          Type : string

          Description : Required. The ID of the advertiser this request is for.

          Required : Yes

          Format : int64

          Location : path

          Pattern : ^[^/]+$

        orderBy

          Description : Optional. Field by which to sort the list. The only acceptable values are: `linkedYoutubeAsset.locationAssetFilter.assetSetId`, `linkedYoutubeAsset.affiliateLocationAssetFilter.assetSetId`, `linkedYoutubeAsset.sitelinkAsset.assetId` The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be added to the field name. Example: `linkedYoutubeAsset.sitelinkAsset.assetId desc`.

          Location : query

          Type : string

        youtubeAssetType

          Description : Required. The type of YouTube asset in the association.

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK
        • Required : Yes

          Type : string

          Location : path

          Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Pattern : ^[^/]+$

        pageSize

          Format : int32

          Description : Optional. Requested page size. Must be between `1` and `10000`. If unspecified will default to `100`.

          Type : integer

          Location : query

        pageToken

          Description : Optional. A token identifying a page of results the server should return.

          Location : query

          Type : string

  • displayvideo.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.create

      HTTP Method : POST

      Path : v4/advertisers/{+advertiserId}/adGroups/{+adGroupId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations

      Description : Creates a new association between an entity (line item or ad group) and a YouTube asset. Returns the newly created association if successful.

      Flat Path : v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations

      Parameter Order :

    • advertiserId
    • adGroupId
    • youtubeAssetType
    • Scopes : https://www.googleapis.com/auth/display-video

      Parameters :

        youtubeAssetType

          Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Location : path

          Type : string

          Description : Required. The type of the linked YouTube asset in the association.

          Pattern : ^[^/]+$

          Required : Yes

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK

        adGroupId

          Location : path

          Pattern : ^[^/]+$

          Required : Yes

          Type : string

          Description : The unique ID of the ad group linked.

          Format : int64

        linkedEntity.lineItemId

          Location : query

          Format : int64

          Description : The unique ID of the line item linked.

          Type : string

        advertiserId

          Description : Required. The ID of the advertiser this request is for.

          Pattern : ^[^/]+$

          Required : Yes

          Format : int64

          Type : string

          Location : path

  • displayvideo.advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations.delete

      Description : Deletes an existing association between an entity (line item or ad group) and a YouTube asset.

      Parameters :

        adGroupId

          Type : string

          Format : int64

          Required : Yes

          Description : The unique ID of the ad group linked.

          Pattern : ^[^/]+$

          Location : path

        advertiserId

          Format : int64

          Description : Required. The ID of the advertiser this request is for.

          Required : Yes

          Location : path

          Type : string

          Pattern : ^[^/]+$

        youtubeAssetAssociationId

          Required : Yes

          Location : path

          Type : string

          Format : int64

          Description : Required. The ID of the YouTube asset in the association. For location associations: This should be the ID of the asset set linked, or 0 if the association stands for location asset is disabled. For affiliate location associations: This should be the ID of the asset set linked, or 0 if the association stands for affiliate location asset is disabled. For sitelink associations: This should be the ID of the sitelink asset linked.

          Pattern : ^[^/]+$

        youtubeAssetType

          Description : Required. The YouTube asset type this request is for.

          Location : path

          Type : string

          Pattern : ^[^/]+$

          Enum :

        • YOUTUBE_ASSET_TYPE_UNSPECIFIED
        • YOUTUBE_ASSET_TYPE_LOCATION
        • YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION
        • YOUTUBE_ASSET_TYPE_SITELINK
        • Enum Descriptions :

        • YouTube asset type is not specified or is unknown in this version.
        • Location asset
        • Affiliate location asset
        • Sitelink asset
        • Required : Yes

        linkedEntity.lineItemId

          Type : string

          Location : query

          Format : int64

          Description : The unique ID of the line item linked.

      Flat Path : v4/advertisers/{advertisersId}/adGroups/{adGroupsId}/youtubeAssetTypes/{youtubeAssetTypesId}/youtubeAssetAssociations/{youtubeAssetAssociationsId}

      HTTP Method : DELETE

      Scopes : https://www.googleapis.com/auth/display-video

      Path : v4/advertisers/{+advertiserId}/adGroups/{+adGroupId}/youtubeAssetTypes/{+youtubeAssetType}/youtubeAssetAssociations/{+youtubeAssetAssociationId}

      Parameter Order :

    • advertiserId
    • adGroupId
    • youtubeAssetType
    • youtubeAssetAssociationId