Method: customers.accountLinks.mutate

Tworzy lub usuwa połączenie kont. Od wersji 5 tworzenie nie jest obsługiwane przez AccountLinkService.MutateAccountLink. Użyj interfejsu AccountLinkService.CreateAccountLink.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator zmodyfikowanego klienta.

Treść żądania

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

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

object (AccountLinkOperation)

To pole jest wymagane. Operacja do wykonania na połączeniu.
partialFailure

boolean

Jeśli wartość to prawda, udane operacje będą wykonywane, a nieprawidłowe – będą zwracać błędy. Jeśli ma wartość false (fałsz), wszystkie operacje będą przeprowadzane w ramach jednej transakcji tylko wtedy, gdy będą prawidłowe. Wartość domyślna to false (fałsz).
validateOnly

boolean

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

Treść odpowiedzi

Komunikat z odpowiedzią na zmianę połą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 mutacji.
partialFailureError

object (Status)

Błędy związane z nieudanymi operacjami w trybie częściowej awarii. Zwracana tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli jakiekolwiek błędy wystąpią poza operacjami (na przykład błędy uwierzytelniania), zwrócimy błąd na poziomie RPC.

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.

AccountLinkOperation

Pojedyncza aktualizacja linku do 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)

Pole Maska określa, które pola zasobów są modyfikowane w ramach aktualizacji.

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

object (AccountLink)

Operacja aktualizacji: połączenie kont powinno mieć prawidłową nazwę zasobu.
remove

string

Operacja usuwania: oczekiwana jest nazwa zasobu dla linku do konta, które chcesz usunąć. Ma ona taki format:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Wynik dla połączenia kont zmienia się.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.