Method: customers.accountLinks.mutate

Tworzy lub usuwa połączenie z kontem. Od wersji 5 metoda create nie jest obsługiwana w usłudze AccountLinkService.MutateAccountLink. Zamiast tego użyj metody AccountLinkService.CreateAccountLink.

Lista błędów: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagany. Identyfikator klienta, którego modyfikujesz.

Treść żądania

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

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

object (AccountLinkOperation)

Wymagany. Operacja do wykonania na linku.
partialFailure

boolean

Jeśli wartość to prawda, operacje zakończą się powodzeniem, a nieprawidłowe operacje zwrócą błędy. Jeśli jest to wartość false, wszystkie operacje zostaną wykonane w ramach jednej transakcji, o ile wszystkie są prawidłowe. Wartość domyślna to fałsz.
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 działanie mutate dotyczące łączenia kont.

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

Zapis JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Pola
result

object (MutateAccountLinkResult)

Wynik działania funkcji mutate.
partialFailureError

object (Status)

Błędy dotyczące niepowodzeń operacji w trybie częściowego niepowodzenia. Zwracany tylko wtedy, gdy partialFailure = true i wszystkie błędy występują wewnątrz operacji. Jeśli wystąpią błędy poza operacjami (np. błędy uwierzytelniania), zwracamy błąd na poziomie RPC.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

AccountLinkOperation

pojedyncza zmiana w połączeniu konta;

Zapis JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // 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 do wykonania. operation może być tylko jednym z tych elementów:
update

object (AccountLink)

Operacja aktualizacji: link do konta musi mieć prawidłową nazwę zasobu.
remove

string

Operacja usuwania: wymagana jest nazwa zasobu połączenia konta w tym formacie:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Wynik połączenia kont ulega zmianie.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku pomyślnych operacji.