Method: customers.customAudiences.mutate

Tworzy lub aktualizuje grupy niestandardowych odbiorców. Zwracane są stany operacji.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorQuotaErrorRequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customAudiences:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego niestandardowe listy odbiorców są modyfikowane.

Treść żądania

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

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

object (CustomAudienceOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych niestandardowych odbiorcach.
validateOnly

boolean

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

Treść odpowiedzi

Wiadomość z odpowiedzią na mutację niestandardowej listy odbiorców.

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

Zapis JSON 
{
  "results": [
    {
      object (MutateCustomAudienceResult)
    }
  ]
}
Pola
results[]

object (MutateCustomAudienceResult)

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.

CustomAudienceOperation

Pojedyncza operacja (utworzenie i aktualizacja) listy odbiorców niestandardowych.

Zapis JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomAudience)
  },
  "update": {
    object (CustomAudience)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Pola
updateMask

string (FieldMask format)

Pole Maska określa, które pola zasobów są modyfikowane w ramach aktualizacji.

Jest to lista rozdzielonych przecinkami pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".
Pole sumy operation. Operacja zmiany. operation może mieć tylko jedną z tych wartości:
create

object (CustomAudience)

Operacja tworzenia: nie oczekiwana jest nazwa zasobu dla nowej niestandardowej listy odbiorców.
update

object (CustomAudience)

Operacja aktualizacji: niestandardowa grupa odbiorców powinna mieć prawidłową nazwę zasobu.
remove

string

Operacja usuwania – oczekiwana jest nazwa zasobu usuniętej listy odbiorców w takim formacie:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

Wynik mutacji niestandardowej listy odbiorców.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.