Method: customers.customerManagerLinks.mutate

Aktualisiert Kundenmanager-Links. Vorgangsstatus werden zurückgegeben.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, dessen Verknüpfungen mit Kundenmanagern geändert werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
Felder
operations[]

object (CustomerManagerLinkOperation)

Erforderlich. Die Liste der Vorgänge, die für einzelne Verknüpfungen mit Kundenmanagern ausgeführt werden sollen.
validateOnly

boolean

Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

Antworttext

Antwortnachricht für eine Mutation für den CustomerManagerLink

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
Felder
results[]

object (MutateCustomerManagerLinkResult)

Ein Ergebnis, das die von der mutate-Anfrage betroffene Ressource identifiziert.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CustomerManagerLinkOperation

Aktualisiert den Status einer Verknüpfung vom Typ „CustomerManager“. Folgende Aktionen sind möglich: 1. Bei einem Aktualisierungsvorgang mit dem Status ACTIVE kann eine ausstehende Einladung angenommen werden. 2. Durch den Aktualisierungsvorgang mit dem Status REFUSED wird eine ausstehende Einladung abgelehnt. 3. Bei dem Aktualisierungsvorgang mit dem Status INAKTIV wird die Verknüpfung mit dem Verwaltungskonto beendet.

JSON-Darstellung 
{
  "updateMask": string,

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

string (FieldMask format)

FieldMask, die bestimmt, welche Ressourcenfelder bei einer Aktualisierung geändert werden.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
Union-Feld operation. Der mutate-Vorgang. Für operation ist nur einer der folgenden Werte zulässig:
update

object (CustomerManagerLink)

Aktualisierungsvorgang: Der Link muss einen gültigen Ressourcennamen haben.

MutateCustomerManagerLinkResult

Das Ergebnis für die Verknüpfung des Kundenmanagers ist „mutate“.

JSON-Darstellung 
{
  "resourceName": string
}
Felder
resourceName

string

Wird für erfolgreiche Vorgänge zurückgegeben.