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/v19/customers/{customerId}/customInterests:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagany. Identyfikator klienta, którego niestandardowe zainteresowania są modyfikowane.

Treść żądania

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

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

object (CustomInterestOperation)

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

boolean

Jeśli to prawda, żądanie jest sprawdzane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Odpowiedź na niestandardowe zapytanie o 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 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.

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)

Parametr FieldMask, który określa, które pola zasobu są modyfikowane w ramach aktualizacji.

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".
Pole unii operation. Operacja zmiany. operation może być tylko jednym z tych elementów:
create

object (CustomInterest)

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

object (CustomInterest)

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

MutateCustomInterestResult

Wynik modyfikacji niestandardowego zainteresowania.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku pomyślnych operacji.