Method: customers.customInterests.mutate

Tworzy lub aktualizuje zainteresowania niestandardowe. Zwracane są stany operacji.

Lista błędów: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, którego zainteresowania niestandardowe zostały zmienione.

Treść żądania

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

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

object (CustomInterestOperation)

Wymagane. Lista operacji do wykonania na poszczególnych niestandardowych zainteresowaniach.
validateOnly

boolean

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

Treść odpowiedzi

Wiadomość z odpowiedzią na niestandardową zmianę zainteresowania.

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

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

object (MutateCustomInterestResult)

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.

CustomInterestOperation

Pojedyncza operacja (tworzenie, aktualizowanie) dotycząca zainteresowania niestandardowego.

Zapis JSON 
{
  "updateMask": string,

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

string (FieldMask format)

FieldMask określa, które pola zasobów są modyfikowane podczas aktualizacji.

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

object (CustomInterest)

Operacja tworzenia: dla nowego zainteresowania niestandardowego nie oczekiwana jest nazwa zasobu.
update

object (CustomInterest)

Operacja aktualizacji: zainteresowanie niestandardowe musi mieć prawidłową nazwę zasobu.

MutateCustomInterestResult

Wynik niestandardowej mutacji zainteresowań.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwrócony w przypadku udanych operacji.