Method: customers.adGroupBidModifiers.mutate

Tworzy, aktualizuje i usuwa modyfikatory stawek grup reklam. Zwracane są stany operacji.

Lista błędów: AdGroupBidModifierError AuthenticationError AuthorizationError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError OperatorError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

Żądanie HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/adGroupBidModifiers:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, którego modyfikatory stawek grupy reklam są modyfikowane.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "operations": [
    {
      object (AdGroupBidModifierOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Pola
operations[]

object (AdGroupBidModifierOperation)

Wymagane. Lista operacji do wykonania na poszczególnych modyfikatorach stawek grup reklam.

partialFailure

boolean

Jeśli ma wartość true (prawda), wykonywane są udane operacje, a nieprawidłowe – zwracają błędy. Jeśli wartość jest równa fałsz, wszystkie operacje zostaną wykonane w ramach jednej transakcji, o ile wszystkie są prawidłowe. Wartość domyślna to fałsz.

validateOnly

boolean

Jeśli to prawda, żądanie jest sprawdzane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.

responseContentType

enum (ResponseContentType)

Ustawienie typu treści odpowiedzi. Określa, czy po zmianie ma zostać zwrócony zasób z możliwością zmiany, czy tylko nazwa zasobu.

Treść odpowiedzi

Komunikat odpowiedzi dotyczący zmiany modyfikatorów stawek grupy reklam.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupBidModifierResult)
    }
  ]
}
Pola
partialFailureError

object (Status)

Błędy dotyczące niepowodzeń operacji w trybie częściowego niepowodzenia. Zwracany tylko wtedy, gdy partialFailure = true i wszystkie błędy występują wewnątrz 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 (MutateAdGroupBidModifierResult)

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.