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 | |
---|---|
customer |
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 ( |
Pola | |
---|---|
operations[] |
Wymagane. Lista operacji do wykonania na poszczególnych modyfikatorach stawek grup reklam. |
partial |
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. |
validate |
Jeśli to prawda, żądanie jest sprawdzane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki. |
response |
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 ( |
Pola | |
---|---|
partial |
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[] |
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.