Tworzy, aktualizuje lub usuwa grupy reklam z planem słów kluczowych. Zwracane są stany operacji.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationError NewResourceCreateError KeywordPlanAdGroupErrorQuotaErrorRequestErrorResourceCountLimitExceededError
Żądanie HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/keywordPlanAdGroups:mutate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta, którego grupy reklam planu słów kluczowych 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 w poszczególnych grupach reklam w planie słów kluczowych. |
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. |
Treść odpowiedzi
Wiadomość z odpowiedzią na mutację grupy reklam planu słów kluczowych.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "partialFailureError": { object ( |
Pola | |
---|---|
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 (na przykład błędy uwierzytelniania), zwrócimy błąd na poziomie RPC. |
results[] |
Wszystkie wyniki dla mutacji. Kolejność wyników jest określana na podstawie kolejności słów kluczowych w pierwotnym żądaniu. |
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.