Method: customers.keywordPlans.mutate

Tworzy, aktualizuje i usuwa plany słów kluczowych. Zwraca stany operacji.

Lista zgłaszanych błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestErrorLimit22}ResourceCountLimitExceededErrorStringLengthError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, którego plany słów kluczowych są modyfikowane.

Treść żądania

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

Zapis JSON 
{
  "operations": [
    {
      object (KeywordPlanOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Pola
operations[]

object (KeywordPlanOperation)

Wymagane. Lista operacji do wykonania na poszczególnych planach słów kluczowych.
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 to prawda, żądanie jest sprawdzane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Odpowiedź na prośbę o zmianę planu słów kluczowych.

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

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

object (Status)

Błędy odnoszące 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ą błędy poza operacjami (np. błędy uwierzytelniania), zwracamy błąd na poziomie RPC.
results[]

object (MutateKeywordPlansResult)

Wszystkie wyniki operacji zamiany.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.