Method: customers.keywordPlanCampaignKeywords.mutate

Tworzy, aktualizuje i usuwa słowa kluczowe w kampanii z planu słów kluczowych. Zwracane są stany operacji.

Lista błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

Żądanie HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagany. Identyfikator klienta, którego słowa kluczowe w kampanii ulegają zmianie.

Treść żądania

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

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

object (KeywordPlanCampaignKeywordOperation)

Wymagany. Lista operacji do wykonania na poszczególnych słowach kluczowych w kampanii w Planie słów kluczowych.
partialFailure

boolean

Jeśli wartość to prawda, operacje zakończą się powodzeniem, a nieprawidłowe operacje zwrócą błędy. Jeśli jest to wartość false, wszystkie operacje zostaną wykonane w ramach jednej transakcji, o ile wszystkie są prawidłowe. Wartość domyślna to 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

Wiadomość z odpowiedzią dotyczącą modyfikacji słowa kluczowego w kampanii z planu słów kluczowych

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

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

object (Status)

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

object (MutateKeywordPlanCampaignKeywordResult)

Wszystkie wyniki operacji zamiany.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.