Method: customers.keywordPlanAdGroupKeywords.mutate

Tworzy, aktualizuje lub usuwa słowa kluczowe w grupie reklam planu słów kluczowych. Zwracane są stany operacji.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanError MutateError QuotaError RequestErrorResourceCountLimitExceededError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/keywordPlanAdGroupKeywords:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego słowa kluczowe w grupie reklam planu słów kluczowych są modyfikowane.

Treść żądania

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

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

object (KeywordPlanAdGroupKeywordOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych słowach kluczowych w planie słów kluczowych w planie słów kluczowych.
partialFailure

boolean

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

boolean

Jeśli ma wartość true (prawda), żądanie jest sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Komunikat odpowiedzi na zmianę słowa kluczowego w grupie reklam Plan słów kluczowych.

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

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

object (Status)

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[]

object (MutateKeywordPlanAdGroupKeywordResult)

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.