Method: customers.uploadUserData

Lädt die angegebenen Nutzerdaten hoch.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
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 einer Nutzerliste für den Kundenabgleich.

Antworttext

Antwortnachricht für UserDataService.UploadUserData Uploads über diesen Dienst werden in der Google Ads-Benutzeroberfläche im Bereich "Segmentmitglieder" der Liste für den Kundenabgleich nicht angezeigt.

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, im Format "jjjj-mm-tt hh:mm:ss+|-hh:mm", z. B. "2019-01-01 12:32:45-08:00".

receivedOperationsCount

integer

Anzahl der Upload-Datenvorgänge, die von der API empfangen wurden.

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 auszufü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 auszuführender Vorgang. Für operation ist nur einer der folgenden Werte zulässig:
create

object (UserData)

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

remove

object (UserData)

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