Method: customers.keywordPlanAdGroups.mutate

Tworzy, aktualizuje lub usuwa grupy reklam planu słów kluczowych. Stany operacji są zwracane.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationError NewResourceCreationErrorQuotaErrorRequestErrorResourceCountLimitExceededError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

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

object (KeywordPlanAdGroupOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych grupach reklam planu słów kluczowych.
partialFailure

boolean

Jeśli ma wartość true (prawda), udane operacje będą wykonywane, a nieprawidłowe – zwrócą błędy. Jeśli ma wartość false (fałsz), wszystkie operacje są wykonywane w ramach jednej transakcji i 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.

Treść odpowiedzi

Wiadomość odpowiedzi dla zmiany grupy reklam planu słów kluczowych.

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

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

object (Status)

Błędy związane z nieudanymi operacjami w trybie awarii częściowych. Zwracany tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli błędy wystąpią poza operacjami (np. błędy uwierzytelniania), zwrócimy błąd na poziomie RPC.
results[]

object (MutateKeywordPlanAdGroupResult)

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 omówieniu protokołu OAuth 2.0.