Method: customers.campaignCriteria.mutate

Tworzy, aktualizuje lub usuwa kryteria. Zwracane są stany operacji.

Lista błędów: AdxError AuthenticationError AuthorizationError CampaignCriterionError CollectionSizeError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError FunctionError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError QuotaError RangeError RegionCodeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

Żądanie HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/campaignCriteria:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagany. Identyfikator klienta, którego kryteria są modyfikowane.

Treść żądania

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

Zapis JSON 
{
  "operations": [
    {
      object (CampaignCriterionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Pola
operations[]

object (CampaignCriterionOperation)

Wymagany. Lista operacji do wykonania na poszczególnych kryteriach.
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.
responseContentType

enum (ResponseContentType)

Ustawienie typu treści odpowiedzi. Określa, czy po zmianie ma zostać zwrócony zasób z możliwością zmiany, czy tylko nazwa zasobu.

Treść odpowiedzi

Odpowiedź na operację zmiany kryteriów kampanii

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

Zapis JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateCampaignCriterionResult)
    }
  ]
}
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 (MutateCampaignCriterionResult)

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.