Method: firstAndThirdPartyAudiences.patch

  • Updates an existing FirstAndThirdPartyAudience, supporting only CUSTOMER_MATCH_CONTACT_INFO and CUSTOMER_MATCH_DEVICE_ID audience types.

  • Requires specifying the FirstAndThirdPartyAudience ID in the path and advertiser ID in the query parameters.

  • Allows updating fields such as displayName, description, and membershipDurationDays using the updateMask query parameter.

  • The request body should contain the updated FirstAndThirdPartyAudience object, and a successful response returns the updated object.

  • Requires authorization with the https://www.googleapis.com/auth/display-video 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/v3/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.