Display & Video 360 API (displayvideo:v2)

2023-01-21

7 new methods | 21 updated methods

Additions

    Methods

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroupAds.get

      Description: Gets a YouTube ad group ad.

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroupAds/{+youtubeAdGroupAdId}

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroupAds/{youtubeAdGroupAdsId}

      HTTP Method: GET

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

      Parameters:

        youtubeAdGroupAdId

          Location: path

          Type: string

          Format: int64

          Pattern: ^[^/]+$

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

          Required: Yes

        advertiserId

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

          Type: string

          Required: Yes

          Pattern: ^[^/]+$

          Format: int64

          Location: path

      Parameter Order:

    • advertiserId
    • youtubeAdGroupAdId

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroupAds.list

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroupAds

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

      HTTP Method: GET

      Description: Lists YouTube ad group ads.

      Parameter Order: advertiserId

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroupAds

      Parameters:

        orderBy

          Location: query

          Type: string

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

        filter

          Type: string

          Description: Allows filtering by custom YouTube ad group ad fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `adGroupAdId` Examples: * All ad group ads under an ad group: `adGroupId="1234"` and its * entityStatus is `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED`: `(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupId="12345"` The length of this field should be no more than 500 characters.

          Location: query

        pageToken

          Location: query

          Type: string

          Description: 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 `ListYoutubeAdGroupAds` method. If not specified, the first page of results will be returned.

        pageSize

          Type: integer

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

          Format: int32

          Location: query

        advertiserId

          Location: path

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

          Required: Yes

          Pattern: ^[^/]+$

          Format: int64

          Type: string

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroups.bulkListAdGroupAssignedTargetingOptions

      Parameter Order: advertiserId

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions

      Parameters:

        pageToken

          Location: query

          Type: string

          Description: A token that lets the client fetch the next page of results. Typically, this is the value of next_page_token returned from the previous call to the `BulkListAdGroupAssignedTargetingOptions` method. If not specified, the first page of results will be returned.

        pageSize

          Type: integer

          Format: int32

          Location: query

          Description: Requested page size. The size must be an integer between `1` and `5000`. If unspecified, the default is '5000'. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.

        orderBy

          Location: query

          Type: string

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

        advertiserId

          Description: Required. The ID of the advertiser the line items belongs to.

          Type: string

          Format: int64

          Location: path

          Pattern: ^[^/]+$

          Required: Yes

        youtubeAdGroupIds

          Format: int64

          Location: query

          Description: Required. The IDs of the youtube ad groups to list assigned targeting options for.

          Repeated: Yes

          Type: string

        filter

          Description: Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR` on the same field. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `targetingType` Examples: * AssignedTargetingOptions of targeting type TARGETING_TYPE_YOUTUBE_VIDEO or TARGETING_TYPE_YOUTUBE_CHANNEL `targetingType="TARGETING_TYPE_YOUTUBE_VIDEO" OR targetingType="TARGETING_TYPE_YOUTUBE_CHANNEL"` The length of this field should be no more than 500 characters.

          Location: query

          Type: string

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroups:bulkListAdGroupAssignedTargetingOptions

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

      Description: Lists assigned targeting options for multiple YouTube ad groups across targeting types.

      HTTP Method: GET

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroups.get

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroups/{+youtubeAdGroupId}

      Description: Gets a YouTube ad group.

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

      HTTP Method: GET

      Parameters:

        youtubeAdGroupId

          Type: string

          Required: Yes

          Format: int64

          Pattern: ^[^/]+$

          Location: path

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

        advertiserId

          Pattern: ^[^/]+$

          Type: string

          Location: path

          Required: Yes

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

          Format: int64

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroups/{youtubeAdGroupsId}

      Parameter Order:

    • advertiserId
    • youtubeAdGroupId

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroups.list

      Description: Lists YouTube ad groups.

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroups

      Parameters:

        filter

          Description: Allows filtering by custom YouTube ad group fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND` and `OR`. Only the restrictions for * the same field can be combined by `OR`. A sequence of restrictions * implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported properties: - `adGroupId` - `displayName` - `entityStatus` - `lineItemId` - `adGroupFormat` Examples: * All ad groups under an line item: `lineItemId="1234"` * All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and `YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM` ad groups under an advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND adGroupFormat="YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM"` The length of this field should be no more than 500 characters.

          Type: string

          Location: query

        pageSize

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

          Type: integer

          Location: query

          Format: int32

        advertiserId

          Format: int64

          Pattern: ^[^/]+$

          Type: string

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

          Location: path

          Required: Yes

        orderBy

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

          Type: string

          Location: query

        pageToken

          Type: string

          Location: query

          Description: 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 `ListYoutubeAdGroups` method. If not specified, the first page of results will be returned.

      Parameter Order: advertiserId

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

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroups

      HTTP Method: GET

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.get

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

      Description: Gets a single targeting option assigned to a YouTube ad group. Inherited targeting is not included.

      HTTP Method: GET

      Parameter Order:

    • advertiserId
    • youtubeAdGroupId
    • targetingType
    • assignedTargetingOptionId

      • Path: v2/advertisers/{+advertiserId}/youtubeAdGroups/{+youtubeAdGroupId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}

      Parameters:

        targetingType

          Location: path

          Required: Yes

          Enum:

        • TARGETING_TYPE_UNSPECIFIED
        • TARGETING_TYPE_CHANNEL
        • TARGETING_TYPE_APP_CATEGORY
        • TARGETING_TYPE_APP
        • TARGETING_TYPE_URL
        • TARGETING_TYPE_DAY_AND_TIME
        • TARGETING_TYPE_AGE_RANGE
        • TARGETING_TYPE_REGIONAL_LOCATION_LIST
        • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
        • TARGETING_TYPE_GENDER
        • TARGETING_TYPE_VIDEO_PLAYER_SIZE
        • TARGETING_TYPE_USER_REWARDED_CONTENT
        • TARGETING_TYPE_PARENTAL_STATUS
        • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
        • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
        • TARGETING_TYPE_DEVICE_TYPE
        • TARGETING_TYPE_AUDIENCE_GROUP
        • TARGETING_TYPE_BROWSER
        • TARGETING_TYPE_HOUSEHOLD_INCOME
        • TARGETING_TYPE_ON_SCREEN_POSITION
        • TARGETING_TYPE_THIRD_PARTY_VERIFIER
        • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
        • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
        • TARGETING_TYPE_ENVIRONMENT
        • TARGETING_TYPE_CARRIER_AND_ISP
        • TARGETING_TYPE_OPERATING_SYSTEM
        • TARGETING_TYPE_DEVICE_MAKE_MODEL
        • TARGETING_TYPE_KEYWORD
        • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
        • TARGETING_TYPE_VIEWABILITY
        • TARGETING_TYPE_CATEGORY
        • TARGETING_TYPE_INVENTORY_SOURCE
        • TARGETING_TYPE_LANGUAGE
        • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
        • TARGETING_TYPE_GEO_REGION
        • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
        • TARGETING_TYPE_EXCHANGE
        • TARGETING_TYPE_SUB_EXCHANGE
        • TARGETING_TYPE_POI
        • TARGETING_TYPE_BUSINESS_CHAIN
        • TARGETING_TYPE_CONTENT_DURATION
        • TARGETING_TYPE_CONTENT_STREAM_TYPE
        • TARGETING_TYPE_NATIVE_CONTENT_POSITION
        • TARGETING_TYPE_OMID
        • TARGETING_TYPE_AUDIO_CONTENT_TYPE
        • TARGETING_TYPE_CONTENT_GENRE
        • TARGETING_TYPE_YOUTUBE_VIDEO
        • TARGETING_TYPE_YOUTUBE_CHANNEL
        • TARGETING_TYPE_SESSION_POSITION

          • Pattern: ^[^/]+$

          Enum Descriptions:

        • Default value when type is not specified or is unknown in this version.
        • Target a channel (a custom group of related websites or apps).
        • Target an app category (for example, education or puzzle games).
        • Target a specific app (for example, Angry Birds).
        • Target a specific url (for example, quora.com).
        • Target ads during a chosen time period on a specific day.
        • Target ads to a specific age range (for example, 18-24).
        • Target ads to the specified regions on a regional location list.
        • Target ads to the specified points of interest on a proximity location list.
        • Target ads to a specific gender (for example, female or male).
        • Target a specific video player size for video ads.
        • Target user rewarded content for video ads.
        • Target ads to a specific parental status (for example, parent or not a parent).
        • Target video or audio ads in a specific content instream position (for example, pre-roll, mid-roll, or post-roll).
        • Target ads in a specific content outstream position.
        • Target ads to a specific device type (for example, tablet or connected TV).
        • Target ads to an audience or groups of audiences. Singleton field, at most one can exist on a single Lineitem at a time.
        • Target ads to specific web browsers (for example, Chrome).
        • Target ads to a specific household income range (for example, top 10%).
        • Target ads in a specific on screen position.
        • Filter web sites through third party verification (for example, IAS or DoubleVerify).
        • Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
        • Filter website content by sensitive categories (for example, adult).
        • Target ads to a specific environment (for example, web or app).
        • Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
        • Target ads to a specific operating system (for example, macOS).
        • Target ads to a specific device make or model (for example, Roku or Samsung).
        • Target ads to a specific keyword (for example, dog or retriever).
        • Target ads to a specific negative keyword list.
        • Target ads to a specific viewability (for example, 80% viewable).
        • Target ads to a specific content category (for example, arts & entertainment).
        • Purchase impressions from specific deals and auction packages.
        • Target ads to a specific language (for example, English or Japanese).
        • Target ads to ads.txt authorized sellers.
        • Target ads to a specific regional location (for example, a city or state).
        • Purchase impressions from a group of deals and auction packages.
        • Purchase impressions from specific exchanges.
        • Purchase impressions from specific sub-exchanges.
        • Target ads around a specific point of interest, such as a notable building, a street address, or latitude/longitude coordinates.
        • Target ads around locations of a business chain within a specific geo region.
        • Target ads to a specific video content duration.
        • Target ads to a specific video content stream type.
        • Target ads to a specific native content position.
        • Target ads in an Open Measurement enabled inventory.
        • Target ads to a specific audio content type.
        • Target ads to a specific content genre.
        • Target ads to a specific YouTube video.
        • Target ads to a specific YouTube channel.
        • Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          • Description: Required. Identifies the type of this assigned targeting option. Supported targeting types include: * `TARGETING_TYPE_GENDER` * `TARGETING_TYPE_AGE_RANGE` * `TARGETING_TYPE_PARENTAL_STATUS` * `TARGETING_TYPE_HOUSEHOLD_INCOME` * `TARGETING_TYPE_AUDIENCE_GROUP` * `TARGETING_TYPE_URL` * `TARGETING_TYPE_APP` * `TARGETING_TYPE_APP_CATEGORY` * `TARGETING_TYPE_KEYWORD` * `TARGETING_TYPE_CATEGORY` * `TARGETING_TYPE_SESSION_POSITION` * `TARGETING_TYPE_YOUTUBE_CHANNEL` * `TARGETING_TYPE_YOUTUBE_VIDEO`

          Type: string

        advertiserId

          Location: path

          Required: Yes

          Format: int64

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

          Type: string

          Pattern: ^[^/]+$

        youtubeAdGroupId

          Pattern: ^[^/]+$

          Format: int64

          Type: string

          Location: path

          Required: Yes

          Description: Required. The ID of the ad group the assigned targeting option belongs to.

        assignedTargetingOptionId

          Type: string

          Location: path

          Description: Required. An identifier unique to the targeting type in this line item that identifies the assigned targeting option being requested.

          Pattern: ^[^/]+$

          Required: Yes

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroups/{youtubeAdGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions/{assignedTargetingOptionsId}

  • ▼ ▲ displayvideo.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.list

      Flat Path: v2/advertisers/{advertisersId}/youtubeAdGroups/{youtubeAdGroupsId}/targetingTypes/{targetingTypesId}/assignedTargetingOptions

      Description: Lists the targeting options assigned to a YouTube ad group. Inherited targeting is not included.

      HTTP Method: GET

      Path: v2/advertisers/{+advertiserId}/youtubeAdGroups/{+youtubeAdGroupId}/targetingTypes/{+targetingType}/assignedTargetingOptions

      Parameter Order:

    • advertiserId
    • youtubeAdGroupId
    • targetingType

      • Parameters:

        filter

          Description: Allows filtering by assigned targeting option properties. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by the logical operator `OR`. * A restriction has the form of `{field} {operator} {value}`. * The operator must be `EQUALS (=)`. * Supported fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"` The length of this field should be no more than 500 characters.

          Type: string

          Location: query

        pageSize

          Location: query

          Type: integer

          Format: int32

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

        advertiserId

          Pattern: ^[^/]+$

          Format: int64

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

          Type: string

          Location: path

          Required: Yes

        orderBy

          Description: Field by which to sort the list. Acceptable values are: * `assignedTargetingOptionId` (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: `assignedTargetingOptionId desc`.

          Type: string

          Location: query

        targetingType

          Type: string

          Description: Required. Identifies the type of assigned targeting options to list. Supported targeting types include: * `TARGETING_TYPE_GENDER` * `TARGETING_TYPE_AGE_RANGE` * `TARGETING_TYPE_PARENTAL_STATUS` * `TARGETING_TYPE_HOUSEHOLD_INCOME` * `TARGETING_TYPE_AUDIENCE_GROUP` * `TARGETING_TYPE_URL` * `TARGETING_TYPE_APP` * `TARGETING_TYPE_APP_CATEGORY` * `TARGETING_TYPE_KEYWORD` * `TARGETING_TYPE_CATEGORY` * `TARGETING_TYPE_SESSION_POSITION` * `TARGETING_TYPE_YOUTUBE_CHANNEL` * `TARGETING_TYPE_YOUTUBE_VIDEO`

          Pattern: ^[^/]+$

          Enum:

        • TARGETING_TYPE_UNSPECIFIED
        • TARGETING_TYPE_CHANNEL
        • TARGETING_TYPE_APP_CATEGORY
        • TARGETING_TYPE_APP
        • TARGETING_TYPE_URL
        • TARGETING_TYPE_DAY_AND_TIME
        • TARGETING_TYPE_AGE_RANGE
        • TARGETING_TYPE_REGIONAL_LOCATION_LIST
        • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
        • TARGETING_TYPE_GENDER
        • TARGETING_TYPE_VIDEO_PLAYER_SIZE
        • TARGETING_TYPE_USER_REWARDED_CONTENT
        • TARGETING_TYPE_PARENTAL_STATUS
        • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
        • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
        • TARGETING_TYPE_DEVICE_TYPE
        • TARGETING_TYPE_AUDIENCE_GROUP
        • TARGETING_TYPE_BROWSER
        • TARGETING_TYPE_HOUSEHOLD_INCOME
        • TARGETING_TYPE_ON_SCREEN_POSITION
        • TARGETING_TYPE_THIRD_PARTY_VERIFIER
        • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
        • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
        • TARGETING_TYPE_ENVIRONMENT
        • TARGETING_TYPE_CARRIER_AND_ISP
        • TARGETING_TYPE_OPERATING_SYSTEM
        • TARGETING_TYPE_DEVICE_MAKE_MODEL
        • TARGETING_TYPE_KEYWORD
        • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
        • TARGETING_TYPE_VIEWABILITY
        • TARGETING_TYPE_CATEGORY
        • TARGETING_TYPE_INVENTORY_SOURCE
        • TARGETING_TYPE_LANGUAGE
        • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
        • TARGETING_TYPE_GEO_REGION
        • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
        • TARGETING_TYPE_EXCHANGE
        • TARGETING_TYPE_SUB_EXCHANGE
        • TARGETING_TYPE_POI
        • TARGETING_TYPE_BUSINESS_CHAIN
        • TARGETING_TYPE_CONTENT_DURATION
        • TARGETING_TYPE_CONTENT_STREAM_TYPE
        • TARGETING_TYPE_NATIVE_CONTENT_POSITION
        • TARGETING_TYPE_OMID
        • TARGETING_TYPE_AUDIO_CONTENT_TYPE
        • TARGETING_TYPE_CONTENT_GENRE
        • TARGETING_TYPE_YOUTUBE_VIDEO
        • TARGETING_TYPE_YOUTUBE_CHANNEL
        • TARGETING_TYPE_SESSION_POSITION

          • Enum Descriptions:

        • Default value when type is not specified or is unknown in this version.
        • Target a channel (a custom group of related websites or apps).
        • Target an app category (for example, education or puzzle games).
        • Target a specific app (for example, Angry Birds).
        • Target a specific url (for example, quora.com).
        • Target ads during a chosen time period on a specific day.
        • Target ads to a specific age range (for example, 18-24).
        • Target ads to the specified regions on a regional location list.
        • Target ads to the specified points of interest on a proximity location list.
        • Target ads to a specific gender (for example, female or male).
        • Target a specific video player size for video ads.
        • Target user rewarded content for video ads.
        • Target ads to a specific parental status (for example, parent or not a parent).
        • Target video or audio ads in a specific content instream position (for example, pre-roll, mid-roll, or post-roll).
        • Target ads in a specific content outstream position.
        • Target ads to a specific device type (for example, tablet or connected TV).
        • Target ads to an audience or groups of audiences. Singleton field, at most one can exist on a single Lineitem at a time.
        • Target ads to specific web browsers (for example, Chrome).
        • Target ads to a specific household income range (for example, top 10%).
        • Target ads in a specific on screen position.
        • Filter web sites through third party verification (for example, IAS or DoubleVerify).
        • Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
        • Filter website content by sensitive categories (for example, adult).
        • Target ads to a specific environment (for example, web or app).
        • Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
        • Target ads to a specific operating system (for example, macOS).
        • Target ads to a specific device make or model (for example, Roku or Samsung).
        • Target ads to a specific keyword (for example, dog or retriever).
        • Target ads to a specific negative keyword list.
        • Target ads to a specific viewability (for example, 80% viewable).
        • Target ads to a specific content category (for example, arts & entertainment).
        • Purchase impressions from specific deals and auction packages.
        • Target ads to a specific language (for example, English or Japanese).
        • Target ads to ads.txt authorized sellers.
        • Target ads to a specific regional location (for example, a city or state).
        • Purchase impressions from a group of deals and auction packages.
        • Purchase impressions from specific exchanges.
        • Purchase impressions from specific sub-exchanges.
        • Target ads around a specific point of interest, such as a notable building, a street address, or latitude/longitude coordinates.
        • Target ads around locations of a business chain within a specific geo region.
        • Target ads to a specific video content duration.
        • Target ads to a specific video content stream type.
        • Target ads to a specific native content position.
        • Target ads in an Open Measurement enabled inventory.
        • Target ads to a specific audio content type.
        • Target ads to a specific content genre.
        • Target ads to a specific YouTube video.
        • Target ads to a specific YouTube channel.
        • Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          • Location: path

          Required: Yes

        pageToken

          Description: 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 `ListYoutubeAdGroupAssignedTargetingOptions` method. If not specified, the first page of results will be returned.

          Location: query

          Type: string

        youtubeAdGroupId

          Required: Yes

          Pattern: ^[^/]+$

          Description: Required. The ID of the ad group to list assigned targeting options for.

          Type: string

          Location: path

          Format: int64

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

Updates

    Methods

  • ▼ ▲ displayvideo.partners.targetingTypes.assignedTargetingOptions.create

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.partners.targetingTypes.assignedTargetingOptions.get

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.partners.targetingTypes.assignedTargetingOptions.list

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.partners.targetingTypes.assignedTargetingOptions.delete

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.targetingTypes.targetingOptions.search

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.targetingTypes.targetingOptions.list

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.targetingTypes.targetingOptions.get

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.advertisers.targetingTypes.assignedTargetingOptions.delete

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.targetingTypes.assignedTargetingOptions.list

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.targetingTypes.assignedTargetingOptions.create

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.advertisers.targetingTypes.assignedTargetingOptions.get

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.lineItems.targetingTypes.assignedTargetingOptions.create

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.advertisers.lineItems.targetingTypes.assignedTargetingOptions.get

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.lineItems.targetingTypes.assignedTargetingOptions.list

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get

      Parameters:

        targetingType

          Enum  TARGETING_TYPE_SESSION_POSITION

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

  • ▼ ▲ displayvideo.advertisers.campaigns.targetingTypes.assignedTargetingOptions.list

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION

  • ▼ ▲ displayvideo.advertisers.campaigns.targetingTypes.assignedTargetingOptions.get

      Parameters:

        targetingType

          Enum Descriptions  Target ads to a serve it in a certain position of a session. Only supported for the AdGroup of YouTube Programmatic Reservation line item.

          Enum  TARGETING_TYPE_SESSION_POSITION