Method: users.ingest

Lädt eine Liste von Nutzern zu den angegebenen Zielen hoch. Im Gegensatz zu audienceMembers.ingest, mit dem Nutzer bestimmten Zielgruppenlisten von Werbetreibenden für die Ausrichtung hinzugefügt werden, werden mit users.ingest Daten zur Identitätsverknüpfung auf Kontoebene (z. B. Nutzer-IDs, die mit Mobilgeräte-IDs verknüpft sind) unabhängig von bestimmten Zielgruppensegmenten erfasst.

Diese Funktion ist nur für Konten auf einer Zulassungsliste verfügbar.

HTTP-Anfrage

POST https://datamanager.googleapis.com/v1/users:ingest

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Felder
destinations[]

object (Destination)

Erforderlich. Die Liste der möglichen Aufnahmeziele.
users[]

object (User)

Erforderlich. Die Liste der Nutzer, die aufgenommen werden sollen.
encryptionInfo

object (EncryptionInfo)

Optional. Verschlüsselungsinformationen zu Verschlüsselungsschlüsseln, die zum Verschlüsseln der Daten verwendet werden.
validateOnly

boolean

Optional. Wenn true, wird die Anfrage validiert, aber nicht ausgeführt.
encoding

enum (Encoding)

Erforderlich. Der Codierungstyp der Nutzer-IDs. Bei verschlüsselten Nutzer-IDs gilt dies nur für die äußere Codierung.

Antworttext

Antwort von IngestUsersRequest.

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

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

string

Die generierte Anfrage-ID der Ingestion Request.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Nutzer

Stellt einen einzelnen Nutzer dar und enthält Kennungen wie personenidentifizierbare Informationen und Mobilgeräte-IDs, die sich alle auf denselben Nutzer beziehen.

JSON-Darstellung 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Felder
userData

object (UserData)

Erforderlich. Mehrere von Nutzern bereitgestellte Daten, die zur Identifizierung des Nutzers verwendet werden.
mobileData

object (MobileData)

Erforderlich. Mehrere Mobilgeräte-ID-Strings, die einen einzelnen Nutzer repräsentieren.