Method: customers.customerClientLinks.mutate

Tworzy lub aktualizuje link klienta. Stany operacji są zwracane.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError NewResourceCreationError QuotaError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego połączenie klienta jest modyfikowane.

Treść żądania

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

Zapis JSON 
{
  "operation": {
    object (CustomerClientLinkOperation)
  },
  "validateOnly": boolean
}
Pola
operation

object (CustomerClientLinkOperation)

To pole jest wymagane. Operacja do wykonania na pojedynczym komponencie CustomerClientLink.
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ą dla mutacji CustomerClientLink.

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

Zapis JSON 
{
  "result": {
    object (MutateCustomerClientLinkResult)
  }
}
Pola
result

object (MutateCustomerClientLinkResult)

Wynik identyfikujący zasób, na który wpływa żądanie mutacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

CustomerClientLinkOperation

Pojedyncza operacja (tworzenie, aktualizowanie) na linku CustomerClientLink.

Zapis JSON 
{
  "updateMask": string,

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

string (FieldMask format)

Maska FieldMask określająca, które pola zasobów są modyfikowane w ramach aktualizacji.

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

object (CustomerClientLink)

Operacja tworzenia: w nowym połączeniu nie oczekiwana jest nazwa zasobu.
update

object (CustomerClientLink)

Operacja aktualizacji: link powinien mieć prawidłową nazwę zasobu.

MutateCustomerClientLinkResult

Wynik dla pojedynczego klienta zmienia się.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.