Method: firstAndThirdPartyAudiences.patch

  • This page details how to update an existing FirstAndThirdPartyAudience using the Display & Video 360 API.

  • Updates are only supported for CUSTOMER_MATCH_CONTACT_INFO and CUSTOMER_MATCH_DEVICE_ID audience types, and for specific fields like displayName, description, and membershipDurationDays.

  • The request requires specifying the audience ID, advertiser ID, and an update mask using the PATCH method.

  • Proper authorization with the https://www.googleapis.com/auth/display-video scope is necessary to make the request.

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/v2/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.