Method: customers.customerClientLinks.mutate

Tworzy lub aktualizuje link klienta. Zwracane są stany operacji.

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/v17/customers/{customerId}/customerClientLinks:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, którego połączenie z klientem jest modyfikowane.

Treść żądania

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

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

object (CustomerClientLinkOperation)

Wymagane. Operacja do wykonania na pojedynczym linku 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

Komunikat 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, którego dotyczy żądanie 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.

CustomerClientLinkOperation

Pojedyncza operacja (tworzenie, aktualizacja) 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)

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

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

object (CustomerClientLink)

Operacja tworzenia: dla nowego połączenia nie ma oczekiwanej nazwy zasobu.
update

object (CustomerClientLink)

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

MutateCustomerClientLinkResult

Zmiana wyniku w przypadku linku klienta jednego klienta.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwrócony w przypadku udanych operacji.