Method: customers.uploadUserData

Lädt die angegebenen Nutzerdaten hoch.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden, für den die Nutzerdaten aktualisiert werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Felder
operations[]

object (UserDataOperation)

Erforderlich. Die Liste der auszuführenden Vorgänge.
Union-Feld metadata. Metadaten der Anfrage. Für metadata ist nur einer der folgenden Werte zulässig:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadaten für Datenaktualisierungen in einer Nutzerliste für den Kundenabgleich

Antworttext

Antwortnachricht für UserDataService.UploadUserData Uploads, die über diesen Dienst durchgeführt wurden, werden auf der Google Ads-Benutzeroberfläche in der Liste zum Kundenabgleich nicht im Bereich „Segmentmitglieder“ aufgeführt.

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

JSON-Darstellung 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Felder
uploadDateTime

string

Das Datum und die Uhrzeit, zu der die Anfrage von der API empfangen wurde, formatiert als „jjjj-mm-tt hh:mm:ss+|-hh:mm“, z. B. „2019-01-01 12:32:45-08:00“.
receivedOperationsCount

integer

Anzahl der von der API empfangenen Uploaddatenvorgänge.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

UserDataOperation

Für UploadUserDataRequest durchzuführender Vorgang

JSON-Darstellung 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Felder
Union-Feld operation. Für UploadUserDataRequest durchzuführender Vorgang Für operation ist nur einer der folgenden Werte zulässig:
create

object (UserData)

Die Liste der Nutzerdaten, die an die Nutzerliste angehängt werden soll.
remove

object (UserData)

Die Liste mit den Nutzerdaten, die aus der Nutzerliste entfernt werden sollen.