Tworzy, aktualizuje i usuwa ustawienia rozszerzeń klientów. Zwracane są stany operacji.
AuthenticationErrorAuthorizationErrorCollectionSizeErrorCriterionErrorDatabaseErrorDateErrorDistinctErrorExtensionSettingErrorFieldErrorHeaderErrorIdErrorInternalErrorListOperationErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError
Żądanie HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerExtensionSettings:mutate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
Wymagane. Identyfikator klienta, którego ustawienia rozszerzenia klienta zmieniają się. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "operations": [ { object ( |
Pola | |
---|---|
operations[] |
Wymagane. Lista operacji do wykonania na ustawieniach rozszerzeń danych klientów. |
partialFailure |
Jeśli ma wartość true (prawda), wykonywane są udane operacje, a nieprawidłowe – zwracają błędy. W przypadku wartości false (fałsz) wszystkie operacje będą wykonywane w ramach jednej transakcji tylko wtedy, gdy są prawidłowe. Wartość domyślna to false (fałsz). |
validateOnly |
Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki. |
responseContentType |
Ustawienie typu treści odpowiedzi. Określa, czy po mutacji powinien zostać zwrócony zasób zmienny, czy tylko jego nazwa. |
Treść odpowiedzi
Zmiana wiadomości z odpowiedzią dotyczącej ustawienia rozszerzenia klienta.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "partialFailureError": { object ( |
Pola | |
---|---|
partialFailureError |
Błędy, które odnoszą się do nieudanych operacji w trybie częściowej awarii. Zwracany tylko wtedy, gdy częściowyFailure ma wartość true (prawda) i wszystkie błędy występują w ramach operacji. Jeśli wystąpią jakieś błędy poza operacjami (na przykład błędy uwierzytelniania), zwrócimy błąd na poziomie RPC. |
results[] |
Wszystkie wyniki dla mutacji. |
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.