Method: users.ingest

Przesyła listę użytkowników do podanych miejsc docelowych. W przeciwieństwie do audienceMembers.ingest (która dodaje użytkowników do konkretnych list odbiorców reklamodawcy na potrzeby kierowania reklam) users.ingest przetwarza dane o powiązaniach tożsamości na poziomie konta (np. identyfikatory użytkowników powiązane z identyfikatorami urządzeń mobilnych) niezależnie od konkretnych segmentów odbiorców.

Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (Destination)

Wymagane. Lista możliwych miejsc docelowych pozyskiwania danych.
users[]

object (User)

Wymagane. Lista użytkowników do przetworzenia.
encryptionInfo

object (EncryptionInfo)

Opcjonalnie: Informacje o szyfrowaniu kluczy szyfrowania używanych do szyfrowania danych.
validateOnly

boolean

Opcjonalnie: Jeśli wartość to true, żądanie jest weryfikowane, ale nie wykonywane.
encoding

enum (Encoding)

Wymagane. Typ kodowania identyfikatorów użytkowników. W przypadku zaszyfrowanych identyfikatorów użytkowników dotyczy to tylko kodowania zewnętrznego.

Treść odpowiedzi

Odpowiedź na żądanie IngestUsersRequest.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requestId": string
}
Pola
requestId

string

Wygenerowany identyfikator żądania dotyczącego przesyłania danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Użytkownik

Reprezentuje pojedynczego użytkownika i zawiera identyfikatory, takie jak informacje umożliwiające identyfikację i identyfikatory urządzeń mobilnych, które odnoszą się do tego samego użytkownika.

Zapis JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Pola
userData

object (UserData)

Wymagane. Wiele rodzajów danych przekazywanych przez użytkowników, które służą do identyfikowania użytkownika.
mobileData

object (MobileData)

Wymagane. Wiele ciągów identyfikatorów urządzeń mobilnych reprezentujących jednego użytkownika.