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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
필드
requestId

string

자동 생성된 요청 ID입니다.
fieldWarnings[]

object (FieldWarning)

필드 경로가 포함된 세부적인 행 수준 경고입니다.

승인 범위

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

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

TermsOfService

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

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

enum (TermsOfServiceStatus)

선택사항입니다. 고객 매치 타겟팅 서비스 약관: https://support.google.com/adspolicy/answer/6299717 UserData 또는 MobileData를 수집할 때 수락해야 합니다. 파트너 매치 사용자 목록에는 이 필드가 필요하지 않습니다.

TermsOfServiceStatus

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

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