Method: users.ingest

제공된 대상에 사용자 목록을 업로드합니다. audienceMembers.ingest (타겟팅을 위해 사용자를 특정 광고주 잠재고객 목록에 추가)와 달리 users.ingest는 특정 잠재고객 세그먼트와 관계없이 계정 수준 ID 연결 데이터 (예: 모바일 ID에 연결된 사용자 식별자)를 수집합니다.

이 기능은 허용 목록에 추가된 계정에서만 사용할 수 있습니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
필드
destinations[]

object (Destination)

필수 항목입니다. 가능한 수집 대상 목록입니다.
users[]

object (User)

필수 항목입니다. 수집할 사용자 목록입니다.
encryptionInfo

object (EncryptionInfo)

선택사항입니다. 데이터를 암호화하는 데 사용되는 암호화 키에 관한 암호화 정보입니다.
validateOnly

boolean

선택사항입니다. true인 경우 요청이 검증되지만 실행되지는 않습니다.
encoding

enum (Encoding)

필수 항목입니다. 사용자 식별자의 인코딩 유형입니다. 암호화된 사용자 식별자의 경우 외부 인코딩에만 적용됩니다.

응답 본문

IngestUsersRequest의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "requestId": string
}
필드
requestId

string

수집 요청의 생성된 요청 ID입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

사용자

단일 사용자를 나타내며, 모두 동일한 사용자를 참조하는 PII 및 휴대기기 ID와 같은 식별자를 포함합니다.

JSON 표현 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
필드
userData

object (UserData)

필수 항목입니다. 사용자를 식별하는 수단으로 사용되는 여러 사용자 제공 데이터입니다.
mobileData

object (MobileData)

필수 항목입니다. 단일 사용자를 나타내는 여러 휴대기기 ID 문자열