- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Wypróbuj
Tworzy lub usuwa zestawy komponentów klienta. Zwracane są stany operacji.
Żądanie HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/customerAssetSets:mutate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta, którego zestawy komponentów klienta są modyfikowane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "operations": [ { object ( |
Pola | |
---|---|
operations[] |
To pole jest wymagane. Lista operacji do wykonania na poszczególnych zbiorach zasobów klienta. |
partialFailure |
Jeśli wartość to prawda, udane operacje będą wykonywane, a nieprawidłowe – będą zwracać błędy. Jeśli ma wartość false (fałsz), wszystkie operacje będą przeprowadzane w ramach jednej transakcji tylko wtedy, gdy będą prawidłowe. Wartość domyślna to false (fałsz). |
validateOnly |
Jeśli ma wartość true (prawda), żądanie jest sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki. |
responseContentType |
Ustawienie typu treści odpowiedzi. Określa, czy po mutacji ma być zwracany zmienny zasób, czy tylko jego nazwa. |
Treść odpowiedzi
Zmieniono wiadomość z odpowiedzią dotyczącą zestawu komponentów klienta.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "results": [ { object ( |
Pola | |
---|---|
results[] |
Wszystkie wyniki dla mutacji. |
partialFailureError |
Błędy związane z nieudanymi operacjami w trybie częściowej awarii. Zwracana tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli jakiekolwiek błędy wystąpią poza operacjami (np. błędy uwierzytelniania), zwrócimy błąd na poziomie RPC. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/adwords
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
CustomerAssetSetOperation
Pojedyncza operacja (tworzenie, usuwanie) na zestawie komponentów klienta.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy operation . Operacja zmiany. operation może mieć tylko jedną z tych wartości: |
|
create |
Operacja tworzenia: nie oczekiwano nazwy zasobu dla nowego zestawu komponentów klienta. |
remove |
Operacja usuwania: oczekiwana jest nazwa zasobu usuniętego zestawu komponentów klienta w tym formacie: |
MutateCustomerAssetSetResult
Zmieniono wynik zestawu komponentów klienta.
Zapis JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Pola | |
---|---|
resourceName |
Zwracany w przypadku udanych operacji. |
customerAssetSet |
Zmutowany komponent klienta zawierający tylko zmienne pola po przekształceniu. To pole zostanie zwrócone tylko wtedy, gdy responseContentType ma wartość „MUTABLE_RESOURCE”. |