Method: customers.customerExtensionSettings.mutate

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

string

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 (CustomerExtensionSettingOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Pola
operations[]

object (CustomerExtensionSettingOperation)

Wymagane. Lista operacji do wykonania na ustawieniach rozszerzeń danych klientów.
partialFailure

boolean

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

boolean

Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.
responseContentType

enum (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 (Status)
  },
  "results": [
    {
      object (MutateCustomerExtensionSettingResult)
    }
  ]
}
Pola
partialFailureError

object (Status)

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[]

object (MutateCustomerExtensionSettingResult)

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.