Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
Method: firstAndThirdPartyAudiences.editCustomerMatchMembers
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aktualizuje listę użytkowników odbiorców kierowania na listę klientów.
Obsługiwane tylko w przypadku tych wartości audienceType:
CUSTOMER_MATCH_CONTACT_INFOCUSTOMER_MATCH_DEVICE_ID
Żądanie HTTP
POST https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
firstAndThirdPartyAudienceId |
string (int64 format)
Wymagane. Identyfikator listy kierowania na listę klientów FirstAndThirdPartyAudience, której członkowie zostaną zmodyfikowani.
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"advertiserId": string,
// Union field added_members can be only one of the following:
"addedContactInfoList": {
object (ContactInfoList)
},
"addedMobileDeviceIdList": {
object (MobileDeviceIdList)
}
// End of list of possible types for union field added_members.
// Union field removed_members can be only one of the following:
"removedContactInfoList": {
object (ContactInfoList)
},
"removedMobileDeviceIdList": {
object (MobileDeviceIdList)
}
// End of list of possible types for union field removed_members.
} |
| Pola |
advertiserId |
string (int64 format)
Wymagane. Identyfikator właściciela reklamodawcy zaktualizowanej listy odbiorców dopasowania do klientów FirstAndThirdPartyAudience.
|
Pole unii added_members. Do listy odbiorców z kierowaniem na listę klientów zostaną dodani członkowie. added_members może być tylko jednym z tych elementów: |
addedContactInfoList |
object (ContactInfoList)
Tylko dane wejściowe. lista informacji kontaktowych określających dodawanych użytkowników;
|
addedMobileDeviceIdList |
object (MobileDeviceIdList)
Tylko dane wejściowe. Lista identyfikatorów urządzeń mobilnych, która określa, których członków należy dodać.
|
Pole unii removed_members. Lista użytkowników, którzy mają zostać usunięci z listy odbiorców kierowania na listę klientów. removed_members może być tylko jednym z tych elementów: |
removedContactInfoList |
object (ContactInfoList)
Tylko dane wejściowe. Lista informacji kontaktowych, która określa użytkowników do usunięcia.
|
removedMobileDeviceIdList |
object (MobileDeviceIdList)
Tylko dane wejściowe. Lista identyfikatorów urządzeń mobilnych, która określa członków do usunięcia.
|
Treść odpowiedzi
Odpowiedź FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"firstAndThirdPartyAudienceId": string
} |
| Pola |
firstAndThirdPartyAudienceId |
string (int64 format)
Wymagane. Identyfikator zaktualizowanej listy odbiorców FirstAndThirdPartyAudience w ramach kierowania na listę klientów.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w OAuth 2.0 Overview.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eEdits the member list of a Customer Match audience, supporting \u003ccode\u003eCUSTOMER_MATCH_CONTACT_INFO\u003c/code\u003e and \u003ccode\u003eCUSTOMER_MATCH_DEVICE_ID\u003c/code\u003e audience types.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the \u003ccode\u003efirstAndThirdPartyAudienceId\u003c/code\u003e in the path and \u003ccode\u003eadvertiserId\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eAllows adding or removing members by providing contact information or mobile device IDs.\u003c/p\u003e\n"],["\u003cp\u003eReturns the \u003ccode\u003efirstAndThirdPartyAudienceId\u003c/code\u003e of the updated audience upon successful completion.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API endpoint updates a Customer Match audience's member list via a `POST` request to a specific URL with the audience ID. The request requires an advertiser ID and allows adding or removing members through contact information or mobile device ID lists. The supported audience types are `CUSTOMER_MATCH_CONTACT_INFO` and `CUSTOMER_MATCH_DEVICE_ID`. The successful response returns the updated Customer Match audience ID, and OAuth scope `https://www.googleapis.com/auth/display-video` is necessary for authorization.\n"],null,["# Method: firstAndThirdPartyAudiences.editCustomerMatchMembers\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.EditCustomerMatchMembersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates the member list of a Customer Match audience.\n\nOnly supported for the following [audienceType](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.audience_type):\n\n- `CUSTOMER_MATCH_CONTACT_INFO`\n- `CUSTOMER_MATCH_DEVICE_ID`\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstAndThirdPartyAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the Customer Match FirstAndThirdPartyAudience whose members will be edited. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"advertiserId\": string, // Union field `added_members` can be only one of the following: \"addedContactInfoList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList) }, \"addedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList) } // End of list of possible types for union field `added_members`. // Union field `removed_members` can be only one of the following: \"removedContactInfoList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList) }, \"removedMobileDeviceIdList\": { object (/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList) } // End of list of possible types for union field `removed_members`. } ``` |\n\n| Fields ||\n|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the owner advertiser of the updated Customer Match FirstAndThirdPartyAudience. |\n| Union field `added_members`. The members to be added to the Customer Match audience. `added_members` can be only one of the following: ||\n| `addedContactInfoList` | `object (`[ContactInfoList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be added. |\n| `addedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList)`)` Input only. A list of mobile device IDs to define the members to be added. |\n| Union field `removed_members`. The members to be removed from the Customer Match audience. `removed_members` can be only one of the following: ||\n| `removedContactInfoList` | `object (`[ContactInfoList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList)`)` Input only. A list of contact information to define the members to be removed. |\n| `removedMobileDeviceIdList` | `object (`[MobileDeviceIdList](/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList)`)` Input only. A list of mobile device IDs to define the members to be removed. |\n\n### Response body\n\nThe response of FirstAndThirdPartyAudienceService.EditCustomerMatchMembers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------|\n| ``` { \"firstAndThirdPartyAudienceId\": string } ``` |\n\n| Fields ||\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `firstAndThirdPartyAudienceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the updated Customer Match FirstAndThirdPartyAudience. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
