Method: audienceMembers.ingest

Lädt eine Liste von AudienceMember-Ressourcen in das angegebene Destination hoch.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Felder
destinations[]

object (Destination)

Erforderlich. Die Liste der Ziele, an die die Zielgruppenmitglieder gesendet werden sollen.
audienceMembers[]

object (AudienceMember)

Erforderlich. Die Liste der Nutzer, die an die angegebenen Ziele gesendet werden sollen. In einer einzelnen Anfrage können maximal 10.000 AudienceMember-Ressourcen gesendet werden.
consent

object (Consent)

Optional. Einwilligung auf Anfrageebene, die auf alle Nutzer in der Anfrage angewendet werden soll. Die Einwilligung auf Nutzerebene überschreibt die Einwilligung auf Anfrageebene und kann in jedem AudienceMember angegeben werden.
validateOnly

boolean

Optional. Für Testzwecke. Wenn true, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.
encoding

enum (Encoding)

Optional. Muss für UserData-Uploads angegeben werden. Der Codierungstyp der Nutzerkennungen. Bei gehashten Nutzerkennungen ist dies der Codierungstyp des gehashten Strings. Bei verschlüsselten gehashten Nutzerkennungen ist dies der Codierungstyp des äußeren verschlüsselten Strings, aber nicht unbedingt des inneren gehashten Strings. Das bedeutet, dass der innere gehashte String anders codiert sein kann als der äußere verschlüsselte String. Bei Uploads, die keine UserData sind, wird dieses Feld ignoriert.
encryptionInfo

object (EncryptionInfo)

Optional. Verschlüsselungsinformationen für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass die hochgeladenen personenidentifizierbaren Informationen gehasht, aber nicht verschlüsselt sind. Bei Uploads, die keine UserData sind, wird dieses Feld ignoriert.
termsOfService

object (TermsOfService)

Optional. Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

Antworttext

Antwort von der IngestAudienceMembersRequest.

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

JSON-Darstellung 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Felder
requestId

string

Die automatisch generierte ID der Anfrage.
fieldWarnings[]

object (FieldWarning)

Detaillierte Warnungen auf Zeilenebene mit Feldpfaden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

TermsOfService

Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

JSON-Darstellung 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Felder
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Optional. Die Nutzungsbedingungen für den Abgleich von Kundendaten: https://support.google.com/adspolicy/answer/6299717. Diese müssen akzeptiert werden, wenn UserData oder MobileData hochgeladen werden. Dieses Feld ist für die Nutzerliste für den Partnerabgleich nicht erforderlich.

TermsOfServiceStatus

Gibt die Entscheidung des Aufrufers an, die Nutzungsbedingungen zu akzeptieren oder abzulehnen.

Enums
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Nicht angegeben.
ACCEPTED Status, der angibt, dass der Aufrufer die Nutzungsbedingungen akzeptiert hat.
REJECTED Status, der angibt, dass der Aufrufer die Nutzungsbedingungen abgelehnt hat.