Method: audienceMembers.ingest

제공된 Destination에 AudienceMember 리소스 목록을 업로드합니다.

HTTP 요청

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

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

요청 본문

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

JSON 표현 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
필드
destinations[]

object (Destination)

필수 항목입니다. 잠재고객 구성원을 보낼 도착 페이지 목록입니다.
audienceMembers[]

object (AudienceMember)

필수 항목입니다. 지정된 도착 페이지로 보낼 사용자 목록입니다. 단일 요청에서 최대 10,000개의 AudienceMember 리소스를 전송할 수 있습니다.
consent

object (Consent)

선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 AudienceMember에서 지정할 수 있습니다.
validateOnly

boolean

선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.
encoding

enum (Encoding)

선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 해싱된 사용자 식별자의 경우 해싱된 문자열의 인코딩 유형입니다. 암호화된 해시 사용자 식별자의 경우 이는 외부 암호화된 문자열의 인코딩 유형이지만 내부 해시 문자열은 아닐 수 있습니다. 즉, 내부 해시 문자열은 외부 암호화된 문자열과 다른 방식으로 인코딩될 수 있습니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
encryptionInfo

object (EncryptionInfo)

선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
termsOfService

object (TermsOfService)

선택사항입니다. 사용자가 수락/거부한 서비스 약관입니다.

응답 본문

IngestAudienceMembersRequest의 응답입니다.

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

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

string

요청의 자동 생성 ID입니다.

승인 범위

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

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

TermsOfService

사용자가 수락/거부한 서비스 약관입니다.

JSON 표현 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
필드
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

선택사항입니다. 고객 일치 타겟팅 서비스 약관: https://support.google.com/adspolicy/answer/6299717 고객 일치 타겟팅 사용자 목록에 업로드하려면 이 약관에 동의해야 합니다.

TermsOfServiceStatus

서비스 약관을 수락하거나 거부하는 호출자의 결정을 나타냅니다.

열거형
TERMS_OF_SERVICE_STATUS_UNSPECIFIED 지정되지 않음
ACCEPTED 호출자가 서비스 약관에 동의하기로 선택했음을 나타내는 상태입니다.
REJECTED 호출자가 서비스 약관을 거부하기로 선택했음을 나타내는 상태입니다.