Method: firstAndThirdPartyAudiences.patch

  • Display & Video 360 API v1 is sunset and this documentation details updating FirstAndThirdPartyAudiences via the API.

  • This update functionality is exclusively for CUSTOMER_MATCH_CONTACT_INFO and CUSTOMER_MATCH_DEVICE_ID audience types.

  • The API request requires specifying the firstAndThirdPartyAudienceId, updateMask, and advertiserId.

  • The request body should contain a FirstAndThirdPartyAudience object with the desired updates, and a successful response will return the updated FirstAndThirdPartyAudience object.

  • Authorization requires the https://www.googleapis.com/auth/display-video OAuth scope.

Updates an existing FirstAndThirdPartyAudience.

Only supported for the following audienceType:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID

HTTP request

PATCH https://displayvideo.googleapis.com/v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
firstAndThirdPartyAudience.firstAndThirdPartyAudienceId

string (int64 format)

Output only. The unique ID of the first and third party audience. Assigned by the system.

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The mask to control which fields to update.

Updates are only supported for the following fields:

  • displayName
  • description
  • membershipDurationDays

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
advertiserId

string (int64 format)

Required. The ID of the owner advertiser of the updated FirstAndThirdPartyAudience.

Request body

The request body contains an instance of FirstAndThirdPartyAudience.

Response body

If successful, the response body contains an instance of FirstAndThirdPartyAudience.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.