Package google.ads.datamanager.v1

색인

• IngestionService(인터페이스)
• MarketingDataInsightsService(인터페이스)
• PartnerLinkService(인터페이스)
• UserListDirectLicenseService(인터페이스)
• UserListGlobalLicenseService(인터페이스)
• UserListService(인터페이스)
• AdIdentifiers(메시지)
• AddressInfo(메시지)
• AgeRange(열거형)
• AudienceMember(메시지)
• AwsWrappedKeyInfo(메시지)
• AwsWrappedKeyInfo.KeyType(열거형)
• Baseline(메시지)
• Baseline.Location(메시지)
• CartData(메시지)
• Consent(메시지)
• ConsentStatus(열거형)
• ContactIdInfo(메시지)
• CreatePartnerLinkRequest(메시지)
• CreateUserListDirectLicenseRequest(메시지)
• CreateUserListGlobalLicenseRequest(메시지)
• CreateUserListRequest(메시지)
• CustomVariable(메시지)
• CustomerType(열거형)
• CustomerValueBucket(열거형)
• DataSourceType(열거형)
• DeletePartnerLinkRequest(메시지)
• DeleteUserListRequest(메시지)
• Destination(메시지)
• DeviceInfo(메시지)
• Encoding(열거형)
• EncryptionInfo(메시지)
• ErrorCount(메시지)
• ErrorInfo(메시지)
• ErrorReason(열거형)
• Event(메시지)
• EventParameter(메시지)
• EventSource(열거형)
• ExperimentalField(메시지)
• GcpWrappedKeyInfo(메시지)
• GcpWrappedKeyInfo.KeyType(열거형)
• Gender(열거형)
• GetUserListDirectLicenseRequest(메시지)
• GetUserListGlobalLicenseRequest(메시지)
• GetUserListRequest(메시지)
• IngestAudienceMembersRequest(메시지)
• IngestAudienceMembersResponse(메시지)
• IngestEventsRequest(메시지)
• IngestEventsResponse(메시지)
• IngestedUserListInfo(메시지)
• IngestedUserListInfo.UploadKeyType(열거형)
• Item(메시지)
• ItemParameter(메시지)
• ListUserListDirectLicensesRequest(메시지)
• ListUserListDirectLicensesResponse(메시지)
• ListUserListGlobalLicenseCustomerInfosRequest(메시지)
• ListUserListGlobalLicenseCustomerInfosResponse(메시지)
• ListUserListGlobalLicensesRequest(메시지)
• ListUserListGlobalLicensesResponse(메시지)
• ListUserListsRequest(메시지)
• ListUserListsResponse(메시지)
• MatchRateRange(열거형)
• MobileData(메시지)
• MobileIdInfo(메시지)
• MobileIdInfo.KeySpace(열거형)
• PairData(메시지)
• PairIdInfo(메시지)
• PartnerAudienceInfo(메시지)
• PartnerAudienceInfo.PartnerAudienceSource(열거형)
• PartnerLink(메시지)
• PpidData(메시지)
• ProcessingErrorReason(열거형)
• ProcessingWarningReason(열거형)
• Product(열거형)(지원 중단됨)
• ProductAccount(메시지)
• ProductAccount.AccountType(열거형)
• PseudonymousIdInfo(메시지)
• PseudonymousIdInfo.SyncStatus(열거형)
• RemoveAudienceMembersRequest(메시지)
• RemoveAudienceMembersResponse(메시지)
• RequestStatusPerDestination(메시지)
• RequestStatusPerDestination.IngestAudienceMembersStatus(메시지)
• RequestStatusPerDestination.IngestEventsStatus(메시지)
• RequestStatusPerDestination.IngestMobileDataStatus(메시지)
• RequestStatusPerDestination.IngestPairDataStatus(메시지)
• RequestStatusPerDestination.IngestPpidDataStatus(메시지)
• RequestStatusPerDestination.IngestUserDataStatus(메시지)
• RequestStatusPerDestination.IngestUserIdDataStatus(메시지)
• RequestStatusPerDestination.RemoveAudienceMembersStatus(메시지)
• RequestStatusPerDestination.RemoveMobileDataStatus(메시지)
• RequestStatusPerDestination.RemovePairDataStatus(메시지)
• RequestStatusPerDestination.RemovePpidDataStatus(메시지)
• RequestStatusPerDestination.RemoveUserDataStatus(메시지)
• RequestStatusPerDestination.RemoveUserIdDataStatus(메시지)
• RequestStatusPerDestination.RequestStatus(열거형)
• RetrieveInsightsRequest(메시지)
• RetrieveInsightsResponse(메시지)
• RetrieveInsightsResponse.MarketingDataInsight(메시지)
• RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(열거형)
• RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(메시지)
• RetrieveRequestStatusRequest(메시지)
• RetrieveRequestStatusResponse(메시지)
• SearchPartnerLinksRequest(메시지)
• SearchPartnerLinksResponse(메시지)
• SizeInfo(메시지)
• TargetNetworkInfo(메시지)
• TermsOfService(메시지)
• TermsOfServiceStatus(열거형)
• UpdateUserListDirectLicenseRequest(메시지)
• UpdateUserListGlobalLicenseRequest(메시지)
• UpdateUserListRequest(메시지)
• UserData(메시지)
• UserIdData(메시지)
• UserIdInfo(메시지)
• UserIdentifier(메시지)
• UserList(메시지)
• UserList.AccessReason(열거형)
• UserList.AccessStatus(열거형)
• UserList.ClosingReason(열거형)
• UserList.MembershipStatus(열거형)
• UserListDirectLicense(메시지)
• UserListGlobalLicense(메시지)
• UserListGlobalLicenseCustomerInfo(메시지)
• UserListGlobalLicenseType(열거형)
• UserListLicenseClientAccountType(열거형)
• UserListLicenseMetrics(메시지)
• UserListLicensePricing(메시지)
• UserListLicensePricing.UserListPricingBuyerApprovalState(열거형)
• UserListLicensePricing.UserListPricingCostType(열거형)
• UserListLicenseStatus(열거형)
• UserProperties(메시지)
• UserProperty(메시지)
• WarningCount(메시지)
• WarningInfo(메시지)

IngestionService

지원되는 대상에 잠재고객 데이터를 전송하는 서비스입니다.

IngestAudienceMembers
rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse) AudienceMember 리소스 목록을 제공된 Destination에 업로드합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

IngestEvents
rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse) 제공된 Destination에서 Event 리소스 목록을 업로드합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

RemoveAudienceMembers
rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse) 제공된 Destination에서 AudienceMember 리소스 목록을 삭제합니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

RetrieveRequestStatus
rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse) 요청 ID가 지정된 요청의 상태를 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

마케팅 데이터에 대한 통계를 반환하는 서비스

이 기능은 데이터 파트너만 사용할 수 있습니다.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse) 지정된 사용자 목록의 마케팅 데이터 통계를 가져옵니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

PartnerLinkService

파트너 링크를 관리하는 서비스입니다.

CreatePartnerLink

rpc CreatePartnerLink(CreatePartnerLinkRequest) returns (PartnerLink) 지정된 계정의 파트너 링크를 만듭니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

DeletePartnerLink

rpc DeletePartnerLink(DeletePartnerLinkRequest) returns (Empty) 지정된 계정의 파트너 링크를 삭제합니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

SearchPartnerLinks

rpc SearchPartnerLinks(SearchPartnerLinksRequest) returns (SearchPartnerLinksResponse) 지정된 계정으로 연결되거나 지정된 계정에서 연결되는 모든 파트너 링크를 검색합니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UserListDirectLicenseService

사용자 목록 직접 라이선스를 관리하는 서비스입니다. 삭제는 UserListDirectLicenses에서 지원되는 작업이 아닙니다. 호출자는 라이선스를 비활성화하는 대신 라이선스 상태를 DISABLED로 업데이트해야 합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

CreateUserListDirectLicense
rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense) 사용자 목록 직접 라이선스를 만듭니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

GetUserListDirectLicense
rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense) 사용자 목록 직접 라이선스를 가져옵니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

ListUserListDirectLicenses
rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse) 상위 계정이 소유한 모든 사용자 목록 직접 라이선스를 나열합니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UpdateUserListDirectLicense
rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense) 사용자 목록 직접 라이선스를 업데이트합니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseService

사용자 목록 전역 라이선스를 관리하는 서비스입니다. 삭제는 UserListGlobalLicenses에서 지원되는 작업이 아닙니다. 호출자는 라이선스를 비활성화하는 대신 라이선스 상태를 DISABLED로 업데이트해야 합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

CreateUserListGlobalLicense
rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense) 사용자 목록 전역 라이선스를 만듭니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

GetUserListGlobalLicense
rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense) 사용자 목록 전역 라이선스를 가져옵니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

ListUserListGlobalLicenseCustomerInfos
rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse) 사용자 목록 전역 라이선스의 모든 고객 정보를 나열합니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

ListUserListGlobalLicenses
rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse) 상위 계정이 소유한 모든 사용자 목록 전역 라이선스를 나열합니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UpdateUserListGlobalLicense
rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense) 사용자 목록 전역 라이선스를 업데이트합니다. 이 기능은 데이터 파트너만 사용할 수 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UserListService

UserList 리소스를 관리하는 서비스입니다.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList) UserList를 만듭니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty) UserList를 삭제합니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList) UserList를 가져옵니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse) UserList를 나열합니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList) UserList를 업데이트합니다. 승인 헤더: 이 메서드는 API가 요청에 대한 액세스를 승인하는 방법을 정의하기 위해 다음 선택적 헤더를 지원합니다. login-account: (선택사항) 사용자 인증 정보의 Google 계정이 사용자인 계정의 리소스 이름입니다. 설정하지 않으면 요청 계정이 기본값입니다. 형식: accountTypes/{loginAccountType}/accounts/{loginAccountId} linked-account: (선택사항) login-account에 연결된 제품 링크가 있는 계정의 리소스 이름입니다. 형식: accountTypes/{linkedAccountType}/accounts/{linkedAccountId} 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/datamanager

AdIdentifiers

전환 이벤트를 광고 클릭과 같은 다른 온라인 활동과 일치시키는 데 사용되는 식별자 및 기타 정보

필드
session_attributes	string 선택사항입니다. 이벤트 기여 분석 및 모델링을 위한 세션 속성입니다.
gclid	string 선택사항입니다. 이 이벤트와 연결된 Google 클릭 ID (gclid)입니다.
gbraid	string 선택사항입니다. iOS14 이후의 iOS 기기에서 발생해 앱 이벤트와 연결된 클릭의 클릭 식별자입니다.
wbraid	string 선택사항입니다. iOS14 이후의 iOS 기기에서 발생해 웹 이벤트와 연결된 클릭의 클릭 식별자입니다.
landing_page_device_info	DeviceInfo 선택사항입니다. 광고와 상호작용한 후 광고주의 사이트에 방문할 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우).

AddressInfo

사용자의 주소 정보입니다.

필드
given_name	string 필수 항목입니다. 사용자의 이름 (first name)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.
family_name	string 필수 항목입니다. 사용자의 성 (마지막 이름)입니다. 모두 소문자이며, 구두점과 앞뒤 공백이 없고 SHA-256으로 해싱됩니다.
region_code	string 필수 항목입니다. 사용자 주소의 ISO-3166-1 alpha-2에 따른 2자리 지역 코드입니다.
postal_code	string 필수 항목입니다. 사용자 주소의 우편번호입니다.

연령

인구통계 연령대

열거형
AGE_RANGE_UNSPECIFIED	지정되지 않음
AGE_RANGE_UNKNOWN	알 수 없음
AGE_RANGE_18_24	만 18~24세
AGE_RANGE_25_34	만 25~34세
AGE_RANGE_35_44	만 35~44세
AGE_RANGE_45_54	만 45~54세
AGE_RANGE_55_64	만 55~64세
AGE_RANGE_65_UP	65세 이상

AudienceMember

작업할 잠재고객 구성원입니다.

필드
destination_references[]	string 선택사항입니다. 잠재고객 구성원을 보낼 Destination을 정의합니다.
consent	Consent 선택사항입니다. 사용자의 동의 설정입니다.
통합 필드 data. 작업할 식별 데이터의 유형입니다. data은 다음 중 하나여야 합니다.
user_data	UserData 사용자를 식별하는 사용자 제공 데이터입니다.
pair_data	PairData 게시자와 광고주의 식별 정보 매칭 솔루션 (PAIR) ID 이 기능은 데이터 파트너만 사용할 수 있습니다.
mobile_data	MobileData 사용자의 휴대기기를 식별하는 데이터입니다.
user_id_data	UserIdData 광고주가 정의한 사용자의 고유 식별자와 관련된 데이터입니다.
ppid_data	PpidData 게시자 제공 식별자와 관련된 데이터입니다. 이 기능은 데이터 파트너만 사용할 수 있습니다.

AwsWrappedKeyInfo

AWS KMS 키로 래핑된 데이터 암호화 키입니다.

필드
key_type	KeyType 필수 항목입니다. 데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.
role_arn	string 필수 항목입니다. KMS 복호화 액세스를 위해 맡을 IAM 역할의 Amazon 리소스 이름입니다. arn:{partition}:iam::{account_id}:role/{role_name} 형식이어야 합니다.
kek_uri	string 필수 항목입니다. DEK를 복호화하는 데 사용되는 AWS KMS 키의 URI입니다. arn:{partition}:kms:{region}:{account_id}:key/{key_id} 또는 aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id} 형식이어야 합니다.
encrypted_dek	string 필수 항목입니다. base64로 인코딩된 암호화된 데이터 암호화 키입니다.

KeyType

데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.

열거형
KEY_TYPE_UNSPECIFIED	지정되지 않은 키 유형입니다. 절대로 사용하지 마세요.
XCHACHA20_POLY1305	알고리즘 XChaCha20-Poly1305

기준

통계가 비교되는 기준선 기준입니다.

필드
통합 필드 baseline. 통계를 비교할 기준 위치입니다. baseline은 다음 중 하나여야 합니다.
baseline_location	Location 요청의 기준 위치입니다. 기준 위치는 요청된 지역의 OR 목록입니다.
location_auto_detection_enabled	bool true로 설정하면 서비스에서 통계의 기준 위치를 자동으로 감지하려고 시도합니다.

위치

요청의 기준 위치입니다. 기준 위치는 요청된 지역의 ISO 3166-1 alpha-2 지역 코드의 OR 목록에 있습니다.

필드
region_codes[]	string ISO 3166-1 alpha-2 지역 코드 목록입니다.

CartData

이벤트와 연결된 장바구니 데이터입니다.

필드
merchant_id	string 선택사항입니다. 상품과 연결된 판매자 센터 ID입니다.
merchant_feed_label	string 선택사항입니다. 상품 피드와 연결된 판매자 센터 피드 라벨입니다.
merchant_feed_language_code	string 선택사항입니다. 상품이 업로드된 판매자 센터 피드와 연결된 ISO 639-1의 언어 코드입니다.
transaction_discount	double 선택사항입니다. 거래와 관련된 모든 할인 금액의 합계입니다.
items[]	Item 선택사항입니다. 이벤트와 연결된 항목 목록입니다.

동의

사용자의 디지털 시장법 (DMA) 동의 설정입니다.

필드
ad_user_data	ConsentStatus 선택사항입니다. 사용자가 광고 사용자 데이터에 동의하는지 여부를 나타냅니다.
ad_personalization	ConsentStatus 선택사항입니다. 사용자가 광고 개인 최적화에 동의하는지 여부를 나타냅니다.

ConsentStatus

사용자가 동의를 부여했는지, 거부했는지, 지정하지 않았는지를 나타냅니다.

열거형
CONSENT_STATUS_UNSPECIFIED	지정되지 않음
CONSENT_GRANTED	허용됨
CONSENT_DENIED	거부되었습니다.

ContactIdInfo

CONTACT_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.

필드
match_rate_percentage	int32 출력 전용입니다. 고객 매치 타겟팅 사용자 목록의 일치율입니다.
data_source_type	DataSourceType 선택사항입니다. 변경할 수 없습니다. 업로드 데이터의 소스

CreatePartnerLinkRequest

PartnerLink 리소스 생성 요청입니다. PartnerLink를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 이 파트너 링크 컬렉션을 소유한 상위 항목입니다. 형식: accountTypes/{account_type}/accounts/{account}
partner_link	PartnerLink 필수 항목입니다. 만들 파트너 링크입니다.

CreateUserListDirectLicenseRequest

UserListDirectLicense 리소스 생성 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 라이선스가 부여된 사용자 목록을 소유한 계정입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} 형식이어야 합니다.
user_list_direct_license	UserListDirectLicense 필수 항목입니다. 생성할 사용자 목록 직접 라이선스입니다.

CreateUserListGlobalLicenseRequest

UserListGlobalLicense 리소스 생성 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 라이선스가 부여된 사용자 목록을 소유한 계정입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} 형식이어야 합니다.
user_list_global_license	UserListGlobalLicense 필수 항목입니다. 생성할 사용자 목록 전역 라이선스입니다.

CreateUserListRequest

CreateUserList의 요청 메시지입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 이 사용자 목록이 생성될 상위 계정입니다. 형식: accountTypes/{account_type}/accounts/{account}
user_list	UserList 필수 항목입니다. 생성할 사용자 목록입니다.
validate_only	bool 선택사항입니다. true인 경우 요청이 검증되지만 실행되지는 않습니다.

CustomVariable

광고 전환의 맞춤 변수입니다.

필드
variable	string 선택사항입니다. 설정할 맞춤 변수의 이름입니다. 지정된 대상에 변수가 없으면 무시됩니다.
value	string 선택사항입니다. 맞춤 변수에 저장할 값입니다.
destination_references[]	string 선택사항입니다. 맞춤 변수를 전송할 Event.destination_references를 결정하는 데 사용되는 참조 문자열입니다. 비어 있으면 Event.destination_references가 사용됩니다.

CustomerType

이벤트와 연결된 고객의 유형입니다.

열거형
CUSTOMER_TYPE_UNSPECIFIED	지정되지 않은 CustomerType입니다. 절대로 사용하지 마세요.
NEW	고객이 광고주를 처음 이용합니다.
RETURNING	고객이 광고주에게 반품합니다.
REENGAGED	고객이 광고주와 다시 상호작용했습니다.

CustomerValueBucket

광고주가 평가한 고객의 가치입니다.

열거형
CUSTOMER_VALUE_BUCKET_UNSPECIFIED	지정되지 않은 CustomerValueBucket입니다. 절대로 사용하지 마세요.
LOW	고객의 가치가 낮습니다.
MEDIUM	고객의 가치가 중간입니다.
HIGH	고객의 가치가 높습니다.

DataSourceType

업로드 데이터의 소스를 나타냅니다.

열거형
DATA_SOURCE_TYPE_UNSPECIFIED	지정되지 않음
DATA_SOURCE_TYPE_FIRST_PARTY	업로드된 데이터는 퍼스트 파티 데이터입니다.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU	업로드된 데이터는 서드 파티 신용 기관에서 가져온 것입니다.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE	업로드된 데이터는 서드 파티 유권자 파일에서 가져온 것입니다.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA	업로드된 데이터는 서드 파티 파트너 데이터입니다.

DeletePartnerLinkRequest

PartnerLink 리소스 삭제 요청입니다. google.protobuf.Empty를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
name	string 필수 항목입니다. 삭제할 파트너 링크의 리소스 이름입니다. 형식: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

DeleteUserList 요청 메시지입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
name	string 필수 항목입니다. 삭제할 사용자 목록의 이름입니다. 형식: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
validate_only	bool 선택사항입니다. true인 경우 요청이 검증되지만 실행되지는 않습니다.

대상

데이터를 전송하는 Google 제품입니다. 예를 들어 Google Ads 계정입니다.

필드
reference	string 선택사항입니다. 이 Destination 리소스의 ID로, 요청 내에서 고유합니다. IngestEventsRequest 및 IngestAudienceMembersRequest에서 이 Destination를 참조하는 데 사용됩니다.
login_account	ProductAccount 선택사항입니다. 이 API 호출을 만드는 데 사용된 계정입니다. operating_account에서 데이터를 추가하거나 삭제하려면 이 login_account에 operating_account에 대한 쓰기 액세스 권한이 있어야 합니다. 예를 들어 operating_account의 관리자 계정 또는 operating_account에 연결된 계정입니다.
linked_account	ProductAccount 선택사항입니다. 호출 사용자의 login_account가 설정된 계정 연결을 통해 액세스할 수 있는 계정입니다. 예를 들어 데이터 파트너의 login_account가 클라이언트의 linked_account에 액세스할 수 있습니다. 파트너는 이 필드를 사용하여 linked_account에서 다른 operating_account로 데이터를 보낼 수 있습니다.
operating_account	ProductAccount 필수 항목입니다. 데이터를 전송하거나 데이터를 삭제할 계정입니다.
product_destination_id	string 필수 항목입니다. 제품 계정 내에서 수집할 객체입니다. 예를 들어 Google Ads 잠재고객 ID, Display & Video 360 잠재고객 ID 또는 Google Ads 전환 액션 ID입니다.

DeviceInfo

이벤트가 발생했을 때 사용 중인 기기에 관한 정보입니다 (있는 경우).

필드
user_agent	string 선택사항입니다. 지정된 컨텍스트의 기기 사용자 에이전트 문자열입니다.
ip_address	string 선택사항입니다. 지정된 컨텍스트의 기기 IP 주소입니다. 참고: Google Ads는 유럽 경제 지역 (EEA), 영국 (UK), 스위스 (CH)의 최종 사용자에 대한 IP 주소 일치 타겟팅을 지원하지 않습니다. 이러한 지역에 거주하는 사용자를 타겟팅하는 경우 IP 주소 공유를 조건부로 제외하는 로직을 추가하고, 사이트, 앱, 기타 속성에서 수집하는 데이터에 관한 명확하고 포괄적인 정보를 사용자에게 제공해야 하며, 법률 또는 관련 Google 정책에서 요구하는 경우 동의를 얻어야 합니다. 자세한 내용은 오프라인 전환 가져오기에 대한 정보 페이지를 참고하세요.

인코딩

해시된 식별 정보의 인코딩 유형입니다.

열거형
ENCODING_UNSPECIFIED	지정되지 않은 인코딩 유형입니다. 절대로 사용하지 마세요.
HEX	16진수 인코딩입니다.
BASE64	Base 64 인코딩입니다.

EncryptionInfo

수집되는 데이터의 암호화 정보입니다.

필드
통합 필드 wrapped_key. 데이터를 암호화하는 데 사용되는 래핑된 키입니다. wrapped_key은 다음 중 하나일 수 있습니다.
gcp_wrapped_key_info	GcpWrappedKeyInfo Google Cloud Platform 래핑된 키 정보입니다.
aws_wrapped_key_info	AwsWrappedKeyInfo Amazon Web Services 래핑 키 정보입니다.

ErrorCount

특정 오류 이유의 오류 수입니다.

필드
record_count	int64 특정 이유로 업로드에 실패한 레코드 수입니다.
reason	ProcessingErrorReason 실패한 레코드의 오류 이유입니다.

ErrorInfo

각 오류 유형의 오류 수입니다.

필드
error_counts[]	ErrorCount 오류 이유별 오류 및 개수 목록입니다. 경우에 따라 채워지지 않을 수 있습니다.

ErrorReason

Data Manager API의 오류 이유입니다. 참고: 이 enum은 고정되어 있지 않으며 향후 새 값이 추가될 수 있습니다.

열거형
ERROR_REASON_UNSPECIFIED	이 기본값을 사용하지 마세요.
INTERNAL_ERROR	내부 오류가 발생했습니다.
DEADLINE_EXCEEDED	요청이 응답하는 데 너무 오래 걸렸습니다.
RESOURCE_EXHAUSTED	요청 횟수가 너무 많습니다.
NOT_FOUND	리소스를 찾을 수 없습니다.
PERMISSION_DENIED	사용자에게 권한이 없거나 리소스를 찾을 수 없습니다.
INVALID_ARGUMENT	요청에 문제가 발생했습니다.
REQUIRED_FIELD_MISSING	필수 입력란이 누락되었습니다.
INVALID_FORMAT	형식이 잘못되었습니다.
INVALID_HEX_ENCODING	16진수로 인코딩된 값의 형식이 잘못되었습니다.
INVALID_BASE64_ENCODING	base64로 인코딩된 값의 형식이 잘못되었습니다.
INVALID_SHA256_FORMAT	SHA256으로 인코딩된 값의 형식이 잘못되었습니다.
INVALID_POSTAL_CODE	우편번호가 잘못되었습니다.
INVALID_COUNTRY_CODE	국가 코드가 잘못되었습니다.
INVALID_ENUM_VALUE	enum 값을 사용할 수 없습니다.
INVALID_USER_LIST_TYPE	이 요청에 적용할 수 없는 사용자 목록 유형입니다.
INVALID_AUDIENCE_MEMBER	이 잠재고객 구성원은 유효하지 않습니다.
TOO_MANY_AUDIENCE_MEMBERS	요청당 허용되는 최대 잠재고객 구성원 수는 10,000명입니다.
TOO_MANY_USER_IDENTIFIERS	잠재고객 구성원당 허용되는 최대 사용자 식별자 수는 10개입니다.
TOO_MANY_DESTINATIONS	요청당 허용되는 최대 연결 대상 수는 10개입니다.
INVALID_DESTINATION	이 대상이 유효하지 않습니다.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED	데이터 파트너가 운영 계정 소유 사용자 목록에 액세스할 수 없습니다.
INVALID_MOBILE_ID_FORMAT	모바일 ID 형식이 잘못되었습니다.
INVALID_USER_LIST_ID	사용자 목록이 유효하지 않습니다.
MULTIPLE_DATA_TYPES_NOT_ALLOWED	단일 요청으로 여러 데이터 유형을 수집할 수 없습니다.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER	DataPartner 로그인 계정이 포함된 대상 구성은 모든 대상 구성에서 동일한 로그인 계정을 사용해야 합니다.
TERMS_AND_CONDITIONS_NOT_SIGNED	필수 이용약관에 동의하지 않았습니다.
INVALID_NUMBER_FORMAT	숫자 형식이 잘못되었습니다.
INVALID_CONVERSION_ACTION_ID	전환 액션 ID가 잘못되었습니다.
INVALID_CONVERSION_ACTION_TYPE	전환 액션 유형이 잘못되었습니다.
INVALID_CURRENCY_CODE	지원되지 않는 통화 코드입니다.
INVALID_EVENT	이 이벤트는 유효하지 않습니다.
TOO_MANY_EVENTS	요청당 허용되는 최대 이벤트 수는 10,000개입니다.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	대상 계정에서 리드 확보용 향상된 전환이 사용 설정되어 있지 않습니다.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS	Google 고객 데이터 정책으로 인해 대상 계정에서 향상된 전환을 사용할 수 없습니다. Google 담당자에게 문의하세요.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED	대상 계정에서 향상된 전환 약관에 동의하지 않았습니다.
DUPLICATE_DESTINATION_REFERENCE	요청에 포함된 두 개 이상의 대상에 동일한 참조가 있습니다.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER	데이터 파트너 승인에 지원되지 않는 운영 계정입니다.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER	데이터 파트너 승인에 지원되지 않는 연결된 계정입니다.
NO_IDENTIFIERS_PROVIDED	이벤트 데이터에는 사용자 식별자나 광고 식별자가 포함되지 않습니다.
INVALID_PROPERTY_TYPE	지원되지 않는 속성 유형입니다.
INVALID_STREAM_TYPE	지원되지 않는 스트림 유형입니다.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT	연결된 계정은 로그인 계정이 DATA_PARTNER 계정인 경우에만 지원됩니다.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH	로그인 계정은 지정된 사용 사례의 운영 계정과 동일해야 합니다.
EVENT_TIME_INVALID	이벤트가 허용되는 기간 내에 발생하지 않았습니다.
RESERVED_NAME_USED	매개변수가 예약된 이름을 사용합니다.
INVALID_EVENT_NAME	이벤트 이름이 지원되지 않습니다.
NOT_ALLOWLISTED	계정이 지정된 기능에 대해 허용되지 않습니다.
INVALID_REQUEST_ID	요청 상태를 가져오는 데 사용된 요청 ID가 유효하지 않습니다. 상태는 성공하고 validate_only=true가 없는 요청에 대해서만 가져올 수 있습니다.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT	이벤트에 Google 애널리틱스 대상이 2개 이상 있습니다.
FIELD_VALUE_TOO_LONG	필드 값이 너무 깁니다.
TOO_MANY_ELEMENTS	요청의 목록에 요소가 너무 많습니다.
ALREADY_EXISTS	이미 존재하는 리소스입니다.
IMMUTABLE_FIELD_FOR_UPDATE	업데이트 요청에 변경 불가능한 필드를 설정하려고 시도했습니다.
INVALID_RESOURCE_NAME	리소스 이름이 잘못되었습니다.
INVALID_FILTER	쿼리 필터가 잘못되었습니다.
INVALID_UPDATE_MASK	업데이트 마스크가 잘못되었습니다.
INVALID_PAGE_TOKEN	페이지 토큰이 잘못되었습니다.
CANNOT_UPDATE_DISABLED_LICENSE	사용 중지된 라이선스는 업데이트할 수 없습니다.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST	민감한 사용자 목록은 이 클라이언트에 라이선스를 부여할 수 없습니다.
INSUFFICIENT_COST	이 라이선스의 비용이 너무 낮습니다.
CANNOT_DISABLE_LICENSE	리셀러 라이선스는 사용 중이므로 사용 중지할 수 없습니다.
INVALID_CLIENT_ACCOUNT_ID	잘못된 클라이언트 계정 ID입니다.
PRICING_ONLY_ZERO_COST_ALLOWED	이 고객 계정에는 0이 아닌 비용이 허용되지 않습니다.
PRICE_TOO_HIGH	이 라이선스의 비용이 너무 높습니다.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE	고객이 라이선스를 만들 수 없습니다.
INVALID_PRICING_END_DATE	이 라이선스의 가격 책정 종료일이 잘못되었습니다.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT	공유 또는 라이선스가 부여된 세그먼트가 포함된 논리적 사용자 목록에는 라이선스를 부여할 수 없습니다.
MISMATCHED_ACCOUNT_TYPE	요청의 클라이언트 고객 계정 유형이 고객의 실제 계정 유형과 일치하지 않습니다.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE	라이선스 유형이 미디어 공유 비용을 지원하지 않습니다.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER	클라이언트 고객 유형은 미디어 점유율 비용을 지원하지 않습니다.
INVALID_MEDIA_SHARE_COST	잘못된 미디어 공유 비용입니다.
INVALID_COST_TYPE	비용 유형이 잘못되었습니다.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST	UserList 유형은 미디어 공유 비용을 지원하지 않습니다.
MAX_COST_NOT_ALLOWED	최대 비용은 cost_type MEDIA_SHARE에만 허용됩니다.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED	상거래 잠재고객은 직접 라이선스를 부여받을 수만 있습니다.
INVALID_DESCRIPTION	설명이 잘못되었습니다.
INVALID_DISPLAY_NAME	표시 이름이 잘못되었습니다.
DISPLAY_NAME_ALREADY_USED	표시 이름이 계정의 다른 사용자 목록에 이미 사용되고 있습니다.
OWNERSHIP_REQUIRED_FOR_UPDATE	사용자 목록을 수정하려면 소유권이 필요합니다.
USER_LIST_MUTATION_NOT_SUPPORTED	사용자 목록 유형은 읽기 전용이며 변형을 지원하지 않습니다.
SENSITIVE_USER_LIST_IMMUTABLE	개인 정보 보호에 민감하거나 법적으로 거부된 사용자 목록은 외부 사용자가 변경할 수 없습니다.
BILLABLE_RECORD_COUNT_IMMUTABLE	리마케팅 사용자 목록의 청구 가능한 레코드 필드는 설정된 후에는 수정할 수 없습니다.
USER_LIST_NAME_RESERVED	사용자 목록 이름은 시스템 목록용으로 예약되어 있습니다.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA	광고주가 업로드한 데이터로 만든 리마케팅 목록을 사용하려면 광고주가 허용 목록에 포함되어야 합니다.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE	사용자 목록 유형에 파트너 잠재고객 소스가 지원되지 않습니다.
COMMERCE_PARTNER_NOT_ALLOWED	commerce_partner 필드 설정은 partner_audience_source이 COMMERCE_AUDIENCE인 경우에만 지원됩니다.
UNSUPPORTED_PARTNER_AUDIENCE_INFO	partner_audience_info 필드는 사용자 목록 유형에 지원되지 않습니다.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED	파트너 매치 사용자 목록은 관리자 계정에서 만들 수 없습니다.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA	데이터 파트너가 THIRD_PARTY_PARTNER_DATA의 허용 목록에 추가되지 않았습니다.
ADVERTISER_TOS_NOT_ACCEPTED	광고주가 파트너의 서비스 약관에 동의하지 않았습니다.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA	광고주가 THIRD_PARTY_PARTNER_DATA에 대해 허용 목록에 추가되지 않았습니다.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT	이 사용자 목록 유형은 이 계정에서 지원되지 않습니다.
INVALID_COMMERCE_PARTNER	commerce_partner 필드가 잘못되었습니다.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE	데이터 제공업체가 상거래 잠재고객을 만들 수 있도록 허용되지 않았습니다.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES	사용자 목록 업로드 키 유형이 지원되지 않습니다.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG	수집된 사용자 목록 정보 구성은 지원되지 않습니다.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE	계정 유형이 사용자 목록 유형에 대해 지원되지 않습니다.
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK	계정 유형이 파트너 연결에 지원되지 않습니다.

이벤트

사용자가 광고주의 웹사이트 또는 앱과 상호작용하는 것을 나타내는 이벤트입니다.

필드
destination_references[]	string 선택사항입니다. 대상을 결정하는 데 사용되는 참조 문자열입니다. 비어 있으면 이벤트가 요청의 모든 destinations에 전송됩니다.
transaction_id	string 선택사항입니다. 이 이벤트의 고유 식별자입니다. 여러 데이터 소스를 사용하는 전환에 필요합니다.
event_timestamp	Timestamp 필수 항목입니다. 이벤트가 발생한 시간입니다.
last_updated_timestamp	Timestamp 선택사항입니다. 이벤트가 마지막으로 업데이트된 시간입니다.
user_data	UserData 선택사항입니다. 이벤트와 연결된 사용자를 나타내는 사용자 제공 데이터입니다.
consent	Consent 선택사항입니다. 연결된 사용자가 다양한 유형의 동의를 제공했는지에 관한 정보입니다.
ad_identifiers	AdIdentifiers 선택사항입니다. 전환 이벤트를 광고 클릭과 같은 다른 온라인 활동과 일치시키는 데 사용되는 식별자 및 기타 정보
currency	string 선택사항입니다. 이 이벤트 내의 모든 금전적 가치와 연결된 통화 코드입니다.
event_source	EventSource 선택사항입니다. 이벤트가 발생한 위치 (웹, 앱, 매장 등)를 나타내는 신호입니다.
event_device_info	DeviceInfo 선택사항입니다. 이벤트가 발생했을 때 사용 중인 기기에 관해 수집된 정보입니다 (있는 경우).
cart_data	CartData 선택사항입니다. 거래 및 이벤트와 연결된 상품에 관한 정보입니다.
custom_variables[]	CustomVariable 선택사항입니다. 전환 컨테이너 (전환 액션 또는 FL 활동)로 전송할 추가 키/값 쌍 정보입니다.
experimental_fields[]	ExperimentalField 선택사항입니다. 실험용 필드의 키-값 쌍 목록입니다. 실험용 필드는 결국 API의 일부로 승격될 수 있습니다.
user_properties	UserProperties 선택사항입니다. 이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다.
event_name	string 선택사항입니다. 이벤트 이름 GA4 이벤트에 필요합니다.
client_id	string 선택사항입니다. 이 GA4 웹 스트림의 웹 클라이언트 사용자 인스턴스의 고유 식별자입니다.
user_id	string 선택사항입니다. 광고주가 정의한 사용자의 고유 식별자입니다.
additional_event_parameters[]	EventParameter 선택사항입니다. 다른 구조화된 필드를 사용하여 아직 지정되지 않은 이벤트 내에 포함할 이벤트 매개변수 버킷입니다.
conversion_value	double 선택사항입니다. 가치 기반 전환의 경우 이벤트와 연결된 전환 가치입니다.

EventParameter

GA4 이벤트의 이벤트 매개변수입니다.

필드
parameter_name	string 필수 항목입니다. 사용할 매개변수의 이름입니다.
value	string 필수 항목입니다. 설정할 매개변수 값의 문자열 표현입니다.

EventSource

이벤트의 소스입니다.

열거형
EVENT_SOURCE_UNSPECIFIED	지정되지 않은 EventSource입니다. 절대로 사용하지 마세요.
WEB	이 이벤트는 웹브라우저에서 생성되었습니다.
APP	앱에서 생성된 이벤트입니다.
IN_STORE	이 이벤트는 오프라인 거래에서 생성되었습니다.
PHONE	이 이벤트는 전화 통화에서 생성되었습니다.
OTHER	이 이벤트는 다른 소스에서 생성되었습니다.

ExperimentalField

비공식 필드를 나타내는 실험용 필드입니다.

필드
field	string 선택사항입니다. 사용할 필드의 이름입니다.
value	string 선택사항입니다. 설정할 필드의 값입니다.

GcpWrappedKeyInfo

Google Cloud Platform 래핑된 키에 관한 정보입니다.

필드
key_type	KeyType 필수 항목입니다. 데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.
wip_provider	string 필수 항목입니다. KEK를 사용하는 데 필요한 워크로드 아이덴티티 풀 제공자입니다.
kek_uri	string 필수 항목입니다. Google Cloud Platform Cloud Key Management Service 리소스 ID. projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} 또는 gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} 형식이어야 합니다.
encrypted_dek	string 필수 항목입니다. base64로 인코딩된 암호화된 데이터 암호화 키입니다.

KeyType

데이터를 암호화하는 데 사용된 알고리즘의 유형입니다.

열거형
KEY_TYPE_UNSPECIFIED	지정되지 않은 키 유형입니다. 절대로 사용하지 마세요.
XCHACHA20_POLY1305	알고리즘 XChaCha20-Poly1305

성별

인구통계 성별 유형 (예: 여성)입니다.

열거형
GENDER_UNSPECIFIED	지정되지 않음
GENDER_UNKNOWN	알 수 없음
GENDER_MALE	남성
GENDER_FEMALE	여성

GetUserListDirectLicenseRequest

UserListDirectLicense 리소스를 가져오기 위한 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
name	string 필수 항목입니다. 사용자 목록 직접 라이선스의 리소스 이름입니다.

GetUserListGlobalLicenseRequest

UserListGlobalLicense 리소스를 가져오기 위한 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
name	string 필수 항목입니다. 사용자 목록 전역 라이선스의 리소스 이름입니다.

GetUserListRequest

GetUserList 요청 메시지입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
name	string 필수 항목입니다. 검색할 UserList의 리소스 이름입니다. 형식: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

IngestAudienceMembersRequest

제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestAudienceMembersResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
destinations[]	Destination 필수 항목입니다. 잠재고객 구성원을 보낼 도착 페이지 목록입니다.
audience_members[]	AudienceMember 필수 항목입니다. 지정된 도착 페이지로 보낼 사용자 목록입니다. 단일 요청에서 최대 10,000개의 AudienceMember 리소스를 전송할 수 있습니다.
consent	Consent 선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 AudienceMember에서 지정할 수 있습니다.
validate_only	bool 선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.
encoding	Encoding 선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 해싱된 사용자 식별자의 경우 해싱된 문자열의 인코딩 유형입니다. 암호화된 해시 사용자 식별자의 경우 이는 외부 암호화된 문자열의 인코딩 유형이지만 내부 해시 문자열의 인코딩 유형은 아닐 수 있습니다. 즉, 내부 해시 문자열은 외부 암호화된 문자열과 다른 방식으로 인코딩될 수 있습니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
encryption_info	EncryptionInfo 선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
terms_of_service	TermsOfService 선택사항입니다. 사용자가 수락/거부한 서비스 약관입니다.

IngestAudienceMembersResponse

IngestAudienceMembersRequest의 응답입니다.

필드
request_id	string 요청의 자동 생성 ID입니다.

IngestEventsRequest

제공된 대상에 잠재고객 구성원을 업로드하도록 요청합니다. IngestEventsResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
destinations[]	Destination 필수 항목입니다. 이벤트를 보낼 대상 목록입니다.
events[]	Event 필수 항목입니다. 지정된 대상에 전송할 이벤트 목록입니다. 단일 요청에서 최대 2,000개의 Event 리소스를 전송할 수 있습니다.
consent	Consent 선택사항입니다. 요청의 모든 사용자에게 적용되는 요청 수준 동의입니다. 사용자 수준 동의는 요청 수준 동의보다 우선하며 각 Event에서 지정할 수 있습니다.
validate_only	bool 선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.
encoding	Encoding 선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 해싱된 사용자 식별자의 경우 해싱된 문자열의 인코딩 유형입니다. 암호화된 해시 사용자 식별자의 경우 이는 외부 암호화된 문자열의 인코딩 유형이지만 내부 해시 문자열은 아닐 수 있습니다. 즉, 내부 해시 문자열은 외부 암호화된 문자열과 다른 방식으로 인코딩될 수 있습니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
encryption_info	EncryptionInfo 선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

IngestEventsResponse

IngestEventsRequest의 응답입니다.

필드
request_id	string 요청의 자동 생성 ID입니다.

IngestedUserListInfo

사용자가 제공한 데이터로 채워진 사용자 목록을 나타냅니다.

필드
upload_key_types[]	UploadKeyType 필수 항목. 변경할 수 없습니다. 이 사용자 목록의 업로드 키 유형입니다.
contact_id_info	ContactIdInfo 선택사항입니다. CONTACT_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.
mobile_id_info	MobileIdInfo 선택사항입니다. MOBILE_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.
user_id_info	UserIdInfo 선택사항입니다. USER_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.
pair_id_info	PairIdInfo 선택사항입니다. PAIR_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다. 이 기능은 데이터 파트너만 사용할 수 있습니다.
pseudonymous_id_info	PseudonymousIdInfo 선택사항입니다. PSEUDONYMOUS_ID에 대한 추가 정보는 upload_key_types 중 하나입니다.
partner_audience_info	PartnerAudienceInfo 선택사항입니다. 파트너 잠재고객을 위한 추가 정보입니다. 이 기능은 데이터 파트너만 사용할 수 있습니다.

UploadKeyType

사용자 목록의 가능한 업로드 키 유형을 포함하는 enum입니다.

열거형
UPLOAD_KEY_TYPE_UNSPECIFIED	지정되지 않음
CONTACT_ID	이메일 주소, 전화번호, 실제 주소와 같은 고객 정보
MOBILE_ID	모바일 광고 ID입니다.
USER_ID	서드 파티에서 제공한 사용자 ID입니다.
PAIR_ID	게시자와 광고주의 식별 정보 매칭 솔루션 ID입니다.
PSEUDONYMOUS_ID	데이터 관리 플랫폼 ID: - Google 사용자 ID - 파트너 제공 ID - 게시자 제공 ID - iOS IDFA - Android 광고 ID - Roku ID - Amazon Fire TV ID - Xbox 또는 Microsoft ID

항목

이벤트와 연결된 장바구니의 상품을 나타냅니다.

필드
merchant_product_id	string 선택사항입니다. 판매자 센터 계정 내의 제품 ID입니다.
quantity	int64 선택사항입니다. 이 이벤트와 연결된 상품의 수입니다.
unit_price	double 선택사항입니다. 세금, 배송비, 거래별 할인 금액을 제외한 단위 가격입니다.
item_id	string 선택사항입니다. 상품을 참조하는 고유 식별자입니다.
additional_item_parameters[]	ItemParameter 선택사항입니다. 다른 구조화된 필드를 사용하여 아직 지정되지 않은 이벤트 내에 포함할 상품과 관련된 이벤트 매개변수의 버킷입니다.

ItemParameter

다른 구조화된 필드를 사용하여 아직 지정되지 않은 이벤트 내에 포함할 상품과 관련된 이벤트 매개변수의 버킷입니다.

필드
parameter_name	string 필수 항목입니다. 사용할 매개변수의 이름입니다.
value	string 필수 항목입니다. 설정할 매개변수 값의 문자열 표현입니다.

ListUserListDirectLicensesRequest

지정된 계정의 모든 UserListDirectLicense 리소스를 나열하도록 요청합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 라이선스를 쿼리하는 계정입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} 형식이어야 합니다.
filter	string 선택사항입니다. 목록 요청에 적용할 필터입니다. 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: user_list_id = 123). 지원되는 작업: AND = != > >= < <= 지원되지 않는 필드: name (대신 get 메서드 사용) historical_pricings 및 모든 하위 필드 pricing.start_time pricing.end_time
page_size	int32 선택사항입니다. 페이지당 반환할 최대 라이선스 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 라이선스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
page_token	string 선택사항입니다. 이전 ListUserListDirectLicense 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 ListUserListDirectLicense에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListUserListDirectLicensesResponse

ListUserListDirectLicensesRequest의 응답입니다.

필드
user_list_direct_licenses[]	UserListDirectLicense 요청에 지정된 사용자 목록의 라이선스입니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListUserListGlobalLicenseCustomerInfosRequest

지정된 사용자 목록 전역 라이선스의 모든 UserListGlobalLicenseCustomerInfo 리소스를 나열하도록 요청합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 고객 정보를 쿼리할 글로벌 라이선스입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} 형식이어야 합니다. 계정의 모든 전역 라이선스 고객 정보를 나열하려면 사용자 목록 전역 라이선스 ID를 '-'로 바꿉니다(예: accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).
filter	string 선택사항입니다. 목록 요청에 적용할 필터입니다. 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: user_list_id = 123). 지원되는 작업: AND = != > >= < <= 지원되지 않는 필드: name (대신 get 메서드 사용) historical_pricings 및 모든 하위 필드 pricing.start_time pricing.end_time
page_size	int32 선택사항입니다. 반환할 라이선스의 최대 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 라이선스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
page_token	string 선택사항입니다. 이전 ListUserListDirectLicense 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 ListUserListDirectLicense에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListUserListGlobalLicenseCustomerInfosResponse

[ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest]의 응답입니다.

필드
user_list_global_license_customer_infos[]	UserListGlobalLicenseCustomerInfo 요청에 있는 지정된 라이선스의 고객 정보입니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListUserListGlobalLicensesRequest

지정된 계정의 모든 UserListGlobalLicense 리소스를 나열하도록 요청합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 라이선스를 쿼리하는 계정입니다. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} 형식이어야 합니다.
filter	string 선택사항입니다. 목록 요청에 적용할 필터입니다. 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: user_list_id = 123). 지원되는 작업: AND = != > >= < <= 지원되지 않는 필드: name (대신 get 메서드 사용) historical_pricings 및 모든 하위 필드 pricing.start_time pricing.end_time
page_size	int32 선택사항입니다. 반환할 라이선스의 최대 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 라이선스가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
page_token	string 선택사항입니다. 이전 ListUserListGlobalLicense 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 ListUserListDirectLicense에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListUserListGlobalLicensesResponse

ListUserListGlobalLicensesRequest의 응답입니다.

필드
user_list_global_licenses[]	UserListGlobalLicense 요청에 지정된 사용자 목록의 라이선스입니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListUserListsRequest

ListUserLists 요청 메시지입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 이 사용자 목록 컬렉션을 소유한 상위 계정입니다. 형식: accountTypes/{account_type}/accounts/{account}
page_size	int32 선택사항입니다. 반환할 최대 사용자 목록 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 사용자 목록이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
page_token	string 선택사항입니다. 이전 ListUserLists 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 ListUserLists에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
filter	string 선택사항입니다. 필터 문자열 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: display_name = "list 1"). 지원되는 작업: AND = != > >= < <= : (있음) 지원되는 필드: id display_name description membership_status integration_code access_reason ingested_user_list_info.upload_key_types

ListUserListsResponse

ListUserLists의 응답 메시지입니다.

필드
user_lists[]	UserList 지정된 계정의 사용자 목록입니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

MatchRateRange

업로드 또는 사용자 목록의 일치율 범위입니다.

열거형
MATCH_RATE_RANGE_UNKNOWN	일치율 범위를 알 수 없습니다.
MATCH_RATE_RANGE_NOT_ELIGIBLE	일치율 범위가 적합하지 않습니다.
MATCH_RATE_RANGE_LESS_THAN_20	일치율 범위가 20% 미만입니다([0, 20) 간격).
MATCH_RATE_RANGE_20_TO_30	일치율 범위는 20~30% ([20, 31) 간격)입니다.
MATCH_RATE_RANGE_31_TO_40	일치율 범위는 31~40% ([31, 41) 간격)입니다.
MATCH_RATE_RANGE_41_TO_50	일치율 범위는 41~50% ([41, 51) 간격)입니다.
MATCH_RATE_RANGE_51_TO_60	일치율 범위는 51~60% ([51, 61) 간격)입니다.
MATCH_RATE_RANGE_61_TO_70	일치율 범위는 61~70% ([61, 71) 간격)입니다.
MATCH_RATE_RANGE_71_TO_80	일치율 범위는 71~80% ([71, 81) 간격)입니다.
MATCH_RATE_RANGE_81_TO_90	일치율 범위는 81~90% ([81, 91) 간격)입니다.
MATCH_RATE_RANGE_91_TO_100	일치율 범위는 91% ~100% ([91, 100] 간격)입니다.

MobileData

잠재고객의 모바일 ID입니다. 모바일 ID가 하나 이상 필요합니다.

필드
mobile_ids[]	string 필수 항목입니다. 휴대기기 ID (광고 ID/IDFA) 목록입니다. 단일 AudienceMember에서 최대 10개의 mobileIds을 제공할 수 있습니다.

MobileIdInfo

MOBILE_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.

필드
data_source_type	DataSourceType 선택사항입니다. 변경할 수 없습니다. 업로드 데이터의 소스입니다.
key_space	KeySpace 필수 항목입니다. 변경할 수 없습니다. 모바일 ID의 키 공간입니다.
app_id	string 필수 항목입니다. 변경할 수 없습니다. 데이터가 수집된 모바일 애플리케이션을 고유하게 식별하는 문자열입니다.

KeySpace

모바일 ID의 키 스페이스입니다.

열거형
KEY_SPACE_UNSPECIFIED	지정되지 않음
IOS	iOS 키 스페이스입니다.
ANDROID	Android 키 스페이스입니다.

PairData

잠재고객의 PAIR ID입니다. 하나 이상의 페어링 ID가 필요합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
pair_ids[]	string 필수 항목입니다. 클린룸에서 제공한 PII 데이터로, SHA256으로 해싱되고 PAIR 사용자 목록에 게시자 키를 사용하여 EC 교환 암호로 암호화됩니다. 단일 AudienceMember에서 최대 10개의 pairIds을 제공할 수 있습니다.

PairIdInfo

PAIR_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
match_rate_percentage	int32 출력 전용입니다. 이 필드는 이 사용자 목록과 해당 게시자의 퍼스트 파티 데이터의 멤버십 일치 비율을 나타냅니다. 0~100(포함) 사이여야 합니다.
advertiser_identifier_count	int64 출력 전용입니다. 클린룸 제공업체에 업로드된 광고주의 퍼스트 파티 데이터 레코드 수입니다. 이는 PAIR 사용자 목록의 크기를 나타내지 않습니다.
publisher_id	int64 필수 항목입니다. 변경할 수 없습니다. 게시자와 게시자-광고주 식별 정보 매칭 사용자 목록이 매칭되는 게시자를 식별합니다. 이 필드는 클린룸 제공업체에서 제공하며 해당 클린룸 범위 내에서만 고유합니다. 이 값은 여러 클린룸에서 전역 식별자로 사용할 수 없습니다.
publisher_name	string 선택사항입니다. 타겟팅 환경을 개선하기 위해 UI에 표시할 게시자의 설명이 포함된 이름입니다.
clean_room_identifier	string 필수 항목입니다. 변경할 수 없습니다. 하나의 데이터 클린룸 제공업체 또는 여러 데이터 클린룸 제공업체 간의 고유한 광고주-게시자 관계를 식별합니다.

PartnerAudienceInfo

파트너 잠재고객을 위한 추가 정보입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
partner_audience_source	PartnerAudienceSource 필수 항목. 변경할 수 없습니다. 파트너 잠재고객의 소스입니다.
commerce_partner	string 선택사항입니다. 상거래 파트너 이름입니다. partner_audience_source이 COMMERCE_AUDIENCE인 경우에만 허용됩니다.

PartnerAudienceSource

파트너 잠재고객 소스입니다.

열거형
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED	지정되지 않음
COMMERCE_AUDIENCE	파트너 잠재고객 소스는 상거래 잠재고객입니다.
LINEAR_TV_AUDIENCE	파트너 잠재고객 소스가 기존 TV 잠재고객입니다.
AGENCY_PROVIDER_AUDIENCE	파트너 잠재고객 소스가 대행사/제공업체 잠재고객입니다.

PartnerLink

소유 계정과 파트너 계정 간의 파트너 링크입니다.

필드
name	string 식별자. 파트너 링크의 이름입니다. 형식: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
partner_link_id	string 출력 전용입니다. 파트너 링크 ID입니다.
owning_account	ProductAccount 필수 항목입니다. 파트너 계정에 액세스 권한을 부여하는 소유 계정입니다.
partner_account	ProductAccount 필수 항목입니다. 소유 계정에서 액세스 권한을 부여한 파트너 계정입니다.

PpidData

ppid를 보유하는 게시자 제공 식별자 데이터입니다. ppid가 하나 이상 필요합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
ppids[]	string 필수 항목입니다. 사용자의 게시자 제공 식별자 목록입니다.

ProcessingErrorReason

처리 오류 이유입니다.

열거형
PROCESSING_ERROR_REASON_UNSPECIFIED	처리 오류 이유를 알 수 없습니다.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE	맞춤 변수가 잘못되었습니다.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED	맞춤 변수의 상태가 사용 설정되지 않았습니다.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD	전환 이후 지금까지의 기간이 지원되는 최대 기간보다 깁니다.
PROCESSING_ERROR_REASON_DENIED_CONSENT	사용자 또는 광고주 기본 설정에 의해 광고 사용자 데이터가 거부됩니다.
PROCESSING_ERROR_REASON_NO_CONSENT	광고주가 광고 핵심 플랫폼 서비스에 대한 서드 파티 동의를 제공하지 않았습니다.
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	이 사용자의 전체 동의 (행 수준 동의, 요청 수준 동의, 계정 설정에서 결정됨)를 확인할 수 없습니다.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID	GCLID 및 전환 시간이 동일한 전환이 이미 시스템에 있습니다.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID	동일한 주문 ID와 전환 액션 조합이 포함된 전환이 이미 업로드되었습니다.
PROCESSING_ERROR_REASON_INVALID_GBRAID	gbraid를 디코딩할 수 없습니다.
PROCESSING_ERROR_REASON_INVALID_GCLID	Google 클릭 ID를 디코딩할 수 없습니다.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID	판매자 ID에 숫자가 아닌 문자가 포함되어 있습니다.
PROCESSING_ERROR_REASON_INVALID_WBRAID	wbraid를 디코딩할 수 없습니다.
PROCESSING_ERROR_REASON_INTERNAL_ERROR	내부 오류입니다.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED	대상 계정에서 향상된 전환 약관에 서명하지 않았습니다.
PROCESSING_ERROR_REASON_INVALID_EVENT	이벤트가 잘못되었습니다.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS	일치하는 거래가 최소 기준점 미만입니다.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS	거래가 최소 기준액 미만입니다.
PROCESSING_ERROR_REASON_INVALID_FORMAT	이벤트에 형식 오류가 있습니다.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR	이벤트에 복호화 오류가 있습니다.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR	DEK를 복호화할 수 없습니다.
PROCESSING_ERROR_REASON_INVALID_WIP	WIP의 형식이 잘못되었거나 WIP가 없습니다.
PROCESSING_ERROR_REASON_INVALID_KEK	KEK가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED	증명 조건에 의해 거부되었으므로 WIP를 사용할 수 없습니다.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED	시스템에 KEK에 액세스하는 데 필요한 권한이 없습니다.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED	시스템에서 AWS 인증에 실패했습니다.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	DEK를 사용하여 UserIdentifier 데이터를 복호화하지 못했습니다.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER	사용자가 운영 계정의 광고가 아닌 광고 식별자를 사용하여 이벤트를 수집하려고 했습니다.

ProcessingWarningReason

처리 경고 이유입니다.

열거형
PROCESSING_WARNING_REASON_UNSPECIFIED	처리 경고 이유를 알 수 없습니다.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED	시스템에 KEK에 액세스하는 데 필요한 권한이 없습니다.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR	DEK를 복호화할 수 없습니다.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR	이벤트에 복호화 오류가 있습니다.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED	증명 조건에 의해 거부되었으므로 WIP를 사용할 수 없습니다.
PROCESSING_WARNING_REASON_INVALID_WIP	WIP의 형식이 잘못되었거나 WIP가 없습니다.
PROCESSING_WARNING_REASON_INVALID_KEK	KEK가 잘못되었거나 존재하지 않으므로 데이터를 복호화할 수 없습니다.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	DEK를 사용하여 UserIdentifier 데이터를 복호화하지 못했습니다.
PROCESSING_WARNING_REASON_INTERNAL_ERROR	내부 오류입니다.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED	시스템에서 AWS 인증에 실패했습니다.

제품

이 항목은 지원 중단되었습니다.

지원이 중단되었습니다. 대신 AccountType를 사용하세요. 특정 Google 제품을 나타냅니다.

열거형
PRODUCT_UNSPECIFIED	지정되지 않은 제품입니다. 절대로 사용하지 마세요.
GOOGLE_ADS	Google Ads
DISPLAY_VIDEO_PARTNER	Display & Video 360 파트너입니다.
DISPLAY_VIDEO_ADVERTISER	Display & Video 360 광고주
DATA_PARTNER	데이터 파트너

ProductAccount

특정 계정을 나타냅니다.

필드
product (deprecated)	Product 이 항목은 지원 중단되었습니다. 지원이 중단되었습니다. 대신 account_type를 사용하세요.
account_id	string 필수 항목입니다. 계정의 ID입니다. 예를 들어 Google Ads 계정 ID입니다.
account_type	AccountType 선택사항입니다. 계정 유형입니다. 예를 들면 GOOGLE_ADS입니다. account_type 또는 지원 중단된 product이 필요합니다. 두 값이 모두 설정된 경우 값이 일치해야 합니다.

AccountType

Google 계정 유형을 나타냅니다. 계정 및 대상을 찾는 데 사용됩니다.

열거형
ACCOUNT_TYPE_UNSPECIFIED	지정되지 않은 제품입니다. 절대로 사용하지 마세요.
GOOGLE_ADS	Google Ads
DISPLAY_VIDEO_PARTNER	Display & Video 360 파트너입니다.
DISPLAY_VIDEO_ADVERTISER	Display & Video 360 광고주
DATA_PARTNER	데이터 파트너
GOOGLE_ANALYTICS_PROPERTY	Google Analytics.
GOOGLE_AD_MANAGER_AUDIENCE_LINK	Google Ad Manager 잠재고객 링크입니다.

PseudonymousIdInfo

PSEUDONYMOUS_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.

필드
sync_status	SyncStatus 출력 전용입니다. 사용자 목록의 동기화 상태입니다.
billable_record_count	int64 선택사항입니다. 변경할 수 없습니다. 청구 가능한 레코드 수 (예: 업로드 또는 일치)입니다.

SyncStatus

사용자 목록의 동기화 상태입니다.

열거형
SYNC_STATUS_UNSPECIFIED	지정되지 않음
CREATED	사용자 목록이 자리표시자로 생성되었습니다. 콘텐츠 또는 메타데이터가 아직 동기화되고 있습니다. 사용자 목록을 사용할 수 없습니다.
READY_FOR_USE	사용자 목록을 사용할 수 있습니다. 콘텐츠와 쿠키가 올바르게 동기화되었습니다.
FAILED	사용자 목록 콘텐츠 또는 메타데이터를 동기화하는 중에 오류가 발생했습니다. 사용자 목록을 사용할 수 없습니다.

RemoveAudienceMembersRequest

제공된 대상에서 사용자를 타겟층에서 삭제하도록 요청합니다. RemoveAudienceMembersResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
destinations[]	Destination 필수 항목입니다. 사용자를 삭제할 도착 페이지 목록입니다.
audience_members[]	AudienceMember 필수 항목입니다. 삭제할 사용자의 목록입니다.
validate_only	bool 선택사항입니다. 테스트 목적으로 사용됩니다. true인 경우 요청이 검증되지만 실행되지는 않습니다. 결과가 아닌 오류만 반환됩니다.
encoding	Encoding 선택사항입니다. UserData 업로드에 필요합니다. 사용자 식별자의 인코딩 유형입니다. 암호화된 사용자 식별자의 외부 인코딩에만 적용됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.
encryption_info	EncryptionInfo 선택사항입니다. UserData 업로드의 암호화 정보입니다. 설정되지 않은 경우 업로드된 식별 정보가 해싱되었지만 암호화되지 않은 것으로 간주됩니다. UserData이 아닌 업로드의 경우 이 필드는 무시됩니다.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest의 응답입니다.

필드
request_id	string 요청의 자동 생성 ID입니다.

RequestStatusPerDestination

대상 위치별 요청 상태입니다.

필드
destination	Destination DM API 요청 내의 대상입니다.
request_status	RequestStatus 대상 위치의 요청 상태입니다.
error_info	ErrorInfo 업로드와 관련된 오류 이유와 오류 수를 포함하는 오류 정보 오류입니다.
warning_info	WarningInfo 업로드와 관련된 경고 이유와 경고 수를 포함하는 경고 정보입니다.
통합 필드 status. 대상 위치의 상태입니다. status은 다음 중 하나여야 합니다.
audience_members_ingestion_status	IngestAudienceMembersStatus 수집 잠재고객 구성원 요청의 상태입니다.
events_ingestion_status	IngestEventsStatus 수집 이벤트 요청의 상태입니다.
audience_members_removal_status	RemoveAudienceMembersStatus 잠재고객 구성원 삭제 요청의 상태입니다.

IngestAudienceMembersStatus

수집 잠재고객 구성원 요청의 상태입니다.

필드
통합 필드 status. 대상으로의 잠재고객 구성원 수집 상태입니다. status은 다음 중 하나여야 합니다.
user_data_ingestion_status	IngestUserDataStatus 대상으로의 사용자 데이터 수집 상태입니다.
mobile_data_ingestion_status	IngestMobileDataStatus 대상으로의 모바일 데이터 수집 상태입니다.
pair_data_ingestion_status	IngestPairDataStatus 대상으로의 페어 데이터 수집 상태입니다.
user_id_data_ingestion_status	IngestUserIdDataStatus 대상으로의 사용자 ID 데이터 수집 상태입니다.
ppid_data_ingestion_status	IngestPpidDataStatus 대상에 대한 ppid 데이터 수집 상태입니다.

IngestEventsStatus

이벤트가 대상에 수집되는 상태입니다.

필드
record_count	int64 업로드 요청에서 전송된 총 이벤트 수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 이벤트를 포함합니다.

IngestMobileDataStatus

수집과 관련된 통계가 포함된 대상에 대한 모바일 데이터 수집 상태입니다.

필드
record_count	int64 대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
mobile_id_count	int64 대상에 대한 업로드 요청에서 전송된 모바일 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다.

IngestPairDataStatus

수집과 관련된 통계가 포함된 대상에 대한 쌍 데이터 수집 상태입니다.

필드
record_count	int64 대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
pair_id_count	int64 대상에 대한 업로드 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 쌍 ID를 포함합니다.

IngestPpidDataStatus

수집과 관련된 통계가 포함된 대상에 대한 PPID 데이터 수집 상태입니다.

필드
record_count	int64 대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
ppid_count	int64 대상에 대한 업로드 요청에서 전송된 ppids의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 ppids를 포함합니다.

IngestUserDataStatus

수집과 관련된 통계가 포함된 대상에 대한 사용자 데이터 수집 상태입니다.

필드
record_count	int64 대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
user_identifier_count	int64 대상에 대한 업로드 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청의 모든 사용자 식별자를 포함합니다.
upload_match_rate_range	MatchRateRange 업로드의 일치율 범위입니다.

IngestUserIdDataStatus

수집과 관련된 통계가 포함된 대상에 대한 사용자 ID 데이터 수집 상태입니다.

필드
record_count	int64 대상에 대한 업로드 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
user_id_count	int64 대상에 대한 업로드 요청에서 전송된 사용자 ID의 총 개수입니다. 성공적으로 수집되었는지 여부와 관계없이 요청에 있는 모든 사용자 ID를 포함합니다.

RemoveAudienceMembersStatus

잠재고객 구성원 삭제 요청의 상태입니다.

필드
통합 필드 status. 대상에서 잠재고객 구성원 삭제 상태입니다. status은 다음 중 하나여야 합니다.
user_data_removal_status	RemoveUserDataStatus 대상에서 사용자 데이터 삭제 상태입니다.
mobile_data_removal_status	RemoveMobileDataStatus 대상에서 모바일 데이터 삭제 상태입니다.
pair_data_removal_status	RemovePairDataStatus 대상에서 페어 데이터 삭제 상태입니다.
user_id_data_removal_status	RemoveUserIdDataStatus 대상에서 사용자 ID 데이터 삭제 상태입니다.
ppid_data_removal_status	RemovePpidDataStatus 대상에서 ppid 데이터 삭제 상태입니다.

RemoveMobileDataStatus

대상에서 모바일 데이터 삭제 상태입니다.

필드
record_count	int64 삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
mobile_id_count	int64 삭제 요청에서 전송된 모바일 ID의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 모바일 ID를 포함합니다.

RemovePairDataStatus

대상에서 페어 데이터 삭제 상태입니다.

필드
record_count	int64 삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
pair_id_count	int64 삭제 요청에서 전송된 쌍 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청의 모든 쌍 ID가 포함됩니다.

RemovePpidDataStatus

대상에서 ppid 데이터 삭제 상태입니다.

필드
record_count	int64 삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
ppid_count	int64 삭제 요청에서 전송된 ppids의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 ppids를 포함합니다.

RemoveUserDataStatus

대상에서 사용자 데이터 삭제 상태입니다.

필드
record_count	int64 삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
user_identifier_count	int64 삭제 요청에서 전송된 사용자 식별자의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 사용자 식별자를 포함합니다.

RemoveUserIdDataStatus

대상에서 사용자 ID 데이터 삭제 상태입니다.

필드
record_count	int64 삭제 요청에서 전송된 잠재고객 구성원의 총수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 잠재고객 구성원을 포함합니다.
user_id_count	int64 삭제 요청에 전송된 사용자 ID의 총 개수입니다. 성공적으로 삭제되었는지 여부와 관계없이 요청에 있는 모든 사용자 ID가 포함됩니다.

RequestStatus

요청 상태입니다.

열거형
REQUEST_STATUS_UNKNOWN	요청 상태를 알 수 없습니다.
SUCCESS	요청이 성공했습니다.
PROCESSING	요청이 처리 중입니다.
FAILED	요청에 실패했습니다.
PARTIAL_SUCCESS	요청이 부분적으로 성공했습니다.

RetrieveInsightsRequest

DM API MarketingDataInsightsService.RetrieveInsights 요청 메시지

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 사용자 목록을 소유한 부모 계정입니다. 형식: accountTypes/{account_type}/accounts/{account}
baseline	Baseline 필수 항목입니다. 요청된 통계의 기준입니다.
user_list_id	string 필수 항목입니다. 통계가 요청된 사용자 목록 ID입니다.

RetrieveInsightsResponse

DM API MarketingDataInsightsService.RetrieveInsights의 응답 메시지

필드
marketing_data_insights[]	MarketingDataInsight 마케팅 데이터의 통계를 포함합니다.

MarketingDataInsight

마케팅 데이터에 대한 통계입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
dimension	AudienceInsightsDimension 통계가 속한 측정기준입니다.
attributes[]	MarketingDataInsightsAttribute 지정된 측정기준의 값에 대한 통계입니다.

AudienceInsightsDimension

인사이트 생성에 사용할 수 있는 측정기준입니다.

열거형
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED	지정되지 않음
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN	이 버전에서는 값을 알 수 없습니다.
AFFINITY_USER_INTEREST	관심분야 사용자입니다.
IN_MARKET_USER_INTEREST	구매 의도 UserInterest입니다.
AGE_RANGE	연령대입니다.
GENDER	성별입니다.

MarketingDataInsightsAttribute

동일한 측정기준의 관련 속성 모음에 대한 통계입니다.

필드
user_interest_id	int64 사용자 관심분야 ID입니다.
lift	float 기준과 비교하여 잠재고객이 속성 값에 대해 갖는 효과의 측정값입니다. 범위 [0~1]
age_range	AgeRange 광고효과가 제공되는 잠재고객의 연령대입니다.
gender	Gender 효과가 제공되는 잠재고객의 성별입니다.

RetrieveRequestStatusRequest

특정 요청 ID에 대해 DM API에 전송된 요청의 상태를 가져오기 위한 요청입니다. RetrieveRequestStatusResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
request_id	string (필수 항목) 필수 항목입니다. Data Manager API 요청의 요청 ID입니다.

RetrieveRequestStatusResponse

RetrieveRequestStatusRequest의 응답입니다.

필드
request_status_per_destination[]	RequestStatusPerDestination 목적지별 요청 상태 목록입니다. 상태의 순서는 원래 요청의 대상 순서와 일치합니다.

SearchPartnerLinksRequest

PartnerLink 리소스를 검색하는 요청 SearchPartnerLinksResponse를 반환합니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
parent	string 필수 항목입니다. 파트너 링크를 검색할 계정입니다. filter이 지정되지 않으면 이 계정이 owning_account 또는 partner_account인 모든 파트너 링크가 반환됩니다. 형식: accountTypes/{account_type}/accounts/{account}
page_size	int32 반환할 최대 파트너 링크 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10개의 파트너 링크가 반환됩니다. 최댓값은 100이며, 100을 초과하는 값은 100으로 변환됩니다.
page_token	string 이전 SearchPartnerLinks 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 SearchPartnerLinks에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
filter	string 선택사항입니다. 필터 문자열 모든 필드는 각 조건의 왼쪽에 있어야 합니다 (예: partner_link_id = 123456789). 지원되는 작업: AND = != 지원되는 필드: partner_link_id owning_account.account_type owning_account.account_id partner_account.account_type partner_account.account_id 예: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

SearchPartnerLinksRequest의 응답입니다.

필드
partner_links[]	PartnerLink 지정된 계정의 파트너 링크입니다.
next_page_token	string 다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

SizeInfo

다양한 타겟팅 네트워크에서 이 사용자 목록에 포함된 예상 회원 수입니다.

필드
display_network_members_count	int64 출력 전용입니다. Google 디스플레이 네트워크에서 이 사용자 목록에 있는 회원 수의 추정치입니다.
search_network_members_count	int64 출력 전용입니다. google.com 도메인에서 이 사용자 목록에 있는 예상 회원 수입니다. 검색 캠페인에서 타겟팅할 수 있는 구성원입니다.

TargetNetworkInfo

다양한 타겟 네트워크의 자격 요건 정보입니다.

필드
eligible_for_display	bool 출력 전용입니다. 이 사용자 목록이 Google 디스플레이 네트워크에 적합함을 나타냅니다.
eligible_for_search	bool 선택사항입니다. 이 사용자 목록이 Google 검색 네트워크에 적합한지 여부를 나타냅니다.

TermsOfService

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

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

TermsOfServiceStatus

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

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

UpdateUserListDirectLicenseRequest

UserListDirectLicense 리소스 업데이트 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
user_list_direct_license	UserListDirectLicense 필수 항목입니다. 라이선스의 name 필드는 업데이트할 라이선스를 식별하는 데 사용됩니다.
update_mask	FieldMask 선택사항입니다. 업데이트할 필드 목록입니다. 특수문자 *는 지원되지 않으며 사용하면 INVALID_UPDATE_MASK 오류가 발생합니다.

UpdateUserListGlobalLicenseRequest

UserListGlobalLicense 리소스 업데이트 요청입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
user_list_global_license	UserListGlobalLicense 필수 항목입니다. 라이선스의 name 필드는 업데이트할 라이선스를 식별하는 데 사용됩니다.
update_mask	FieldMask 선택사항입니다. 업데이트할 필드 목록입니다. 특수문자 *는 지원되지 않으며 사용하면 INVALID_UPDATE_MASK 오류가 발생합니다.

UpdateUserListRequest

UpdateUserList 요청 메시지입니다.

REST API 탐색기에서 이 메서드를 사용해 볼 수 있습니다.

REST로 사용해 보기

필드
user_list	UserList 필수 항목입니다. 업데이트할 사용자 목록입니다. 사용자 목록의 name 필드는 업데이트할 사용자 목록을 식별하는 데 사용됩니다. 형식: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
update_mask	FieldMask 선택사항입니다. 업데이트할 필드 목록입니다.
validate_only	bool 선택사항입니다. true인 경우 요청이 검증되지만 실행되지는 않습니다.

UserData

사용자를 식별하는 데이터입니다. 식별자가 하나 이상 필요합니다.

필드
user_identifiers[]	UserIdentifier 필수 항목입니다. 사용자의 식별자입니다. 동일한 유형의 데이터 (예: 여러 이메일 주소)를 여러 개 제공할 수 있습니다. 일치 가능성을 높이려면 식별자를 최대한 많이 제공하세요. AudienceMember 또는 Event 하나에 최대 10개의 userIdentifiers을 제공할 수 있습니다.

UserIdData

사용자 ID를 보유하는 사용자 ID 데이터입니다.

필드
user_id	string 필수 항목입니다. 광고주가 정의한 사용자의 고유 식별자입니다.

UserIdInfo

USER_ID이 upload_key_types 중 하나인 경우의 추가 정보입니다.

필드
data_source_type	DataSourceType 선택사항입니다. 변경할 수 없습니다. 업로드 데이터의 소스입니다.

UserIdentifier

사용자의 단일 식별자입니다.

필드
통합 필드 identifier. 정확히 하나를 지정해야 합니다. identifier은 다음 중 하나여야 합니다.
email_address	string 정규화 후 SHA-256 해시 함수를 사용하여 해싱된 이메일 주소입니다.
phone_number	string 정규화 (E164 표준) 후 SHA-256 해시 함수를 사용하여 해싱된 전화번호입니다.
address	AddressInfo 사용자 주소의 알려진 구성요소입니다. 한 번에 모두 일치하는 식별자의 그룹화를 보유합니다.

UserList

사용자 목록 리소스입니다.

필드
name	string 식별자. 사용자 목록의 리소스 이름입니다. 형식: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
id	int64 출력 전용입니다. 사용자 목록의 고유 ID입니다.
read_only	bool 출력 전용입니다. 사용자가 목록을 수정할 수 있는지 여부를 나타내는 옵션입니다.
membership_duration	Duration 선택사항입니다. 사용자가 사용자 목록에 남아 있는 기간입니다. 유효한 기간은 24시간 (86,400초)의 정확한 배수입니다. 정확히 24시간의 배수가 아닌 값을 제공하면 INVALID_ARGUMENT 오류가 발생합니다.
access_reason	AccessReason 출력 전용입니다. 이 계정에 목록 액세스 권한이 부여된 이유입니다.
size_info	SizeInfo 출력 전용입니다. 다양한 타겟팅 네트워크에서 이 사용자 목록에 포함된 예상 회원 수입니다.
target_network_info	TargetNetworkInfo 선택사항입니다. 다양한 타겟 네트워크의 자격 요건 정보입니다.
display_name	string 필수 항목입니다. 사용자 목록의 표시 이름입니다.
description	string 선택사항입니다. 사용자 목록에 대한 설명입니다.
membership_status	MembershipStatus 선택사항입니다. 이 사용자 목록의 멤버십 상태입니다.
integration_code	string 선택사항입니다. 외부 시스템의 ID입니다. 사용자 목록 판매자가 시스템의 ID를 상호 연관시키는 데 사용됩니다.
closing_reason	ClosingReason 출력 전용입니다. 이 사용자 목록 멤버십 상태가 종료된 이유입니다.
account_access_status	AccessStatus 선택사항입니다. 이 공유가 아직 사용 설정되어 있는지 여부를 나타냅니다. 사용자 목록이 계정과 공유되면 이 필드는 ENABLED로 설정됩니다. 나중에 사용자 목록 소유자는 공유를 취소하고 DISABLED로 설정할 수 있습니다.
통합 필드 user_list_info. 사용자 목록에 관한 추가 정보입니다. user_list_info은 다음 중 하나여야 합니다.
ingested_user_list_info	IngestedUserListInfo 선택사항입니다. 사용자가 수집한 데이터로 채워진 사용자 목록을 나타냅니다.

AccessReason

가능한 액세스 이유를 설명하는 열거형입니다.

열거형
ACCESS_REASON_UNSPECIFIED	지정되지 않음
OWNED	리소스가 사용자 소유입니다.
SHARED	리소스가 사용자에게 공유됩니다.
LICENSED	사용자에게 리소스의 라이선스가 부여되었습니다.
SUBSCRIBED	사용자가 리소스를 구독했습니다.
AFFILIATED	사용자가 리소스에 액세스할 수 있습니다.

AccessStatus

이 클라이언트가 목록에 계속 액세스할 수 있는지 여부를 나타냅니다.

열거형
ACCESS_STATUS_UNSPECIFIED	지정되지 않음
ENABLED	액세스가 사용 설정되어 있습니다.
DISABLED	액세스가 사용 중지되었습니다.

ClosingReason

사용자 목록이 닫힌 이유를 나타냅니다. 이 열거형은 목록이 시스템에 의해 자동으로 닫히는 경우에만 사용됩니다.

열거형
CLOSING_REASON_UNSPECIFIED	지정되지 않음
UNUSED	최근에 타겟팅에 사용되지 않아 사용자 목록이 닫혔습니다. 자세한 내용은 https://support.google.com/google-ads/answer/2472738을 참고하세요.

MembershipStatus

사용자 목록의 상태입니다.

열거형
MEMBERSHIP_STATUS_UNSPECIFIED	지정되지 않음
OPEN	열림 상태 - 사용자 목록에 회원이 추가되고 있으며 타겟팅할 수 있습니다.
CLOSED	닫힘 상태 - 새 회원이 추가되지 않습니다.

UserListDirectLicense

사용자 목록 직접 라이선스입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
name	string 식별자. 사용자 목록 직접 라이선스의 리소스 이름입니다.
user_list_display_name	string 출력 전용입니다. 라이선스가 부여된 사용자 목록의 이름입니다. 이 필드는 읽기 전용입니다.
client_account_display_name	string 출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 이름입니다. 이 필드는 읽기 전용입니다.
pricing	UserListLicensePricing 선택사항입니다. UserListDirectLicense 가격 책정입니다.
historical_pricings[]	UserListLicensePricing 출력 전용입니다. 이 사용자 목록 라이선스의 가격 책정 기록입니다. 이 필드는 읽기 전용입니다.
metrics	UserListLicenseMetrics 출력 전용입니다. 이 라이선스와 관련된 측정항목 이 필드는 읽기 전용이며 ListUserListDirectLicenses 호출에서 시작일과 종료일이 설정된 경우에만 채워집니다.
user_list_id	int64 변경할 수 없습니다. 라이선스가 부여된 사용자 목록의 ID입니다.
client_account_type	UserListLicenseClientAccountType 변경할 수 없습니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 계정 유형입니다.
client_account_id	int64 변경할 수 없습니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 ID입니다.
status	UserListLicenseStatus 선택사항입니다. UserListDirectLicense의 상태입니다(ENABLED 또는 DISABLED).

UserListGlobalLicense

사용자 목록 전역 라이선스입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

필드
name	string 식별자. 사용자 목록 전역 라이선스의 리소스 이름입니다.
user_list_display_name	string 출력 전용입니다. 라이선스가 부여된 사용자 목록의 이름입니다. 이 필드는 읽기 전용입니다.
pricing	UserListLicensePricing 선택사항입니다. UserListGlobalLicense 가격 책정입니다.
historical_pricings[]	UserListLicensePricing 출력 전용입니다. 이 사용자 목록 라이선스의 가격 책정 기록입니다. 이 필드는 읽기 전용입니다.
metrics	UserListLicenseMetrics 출력 전용입니다. 이 라이선스와 관련된 측정항목 이 필드는 읽기 전용이며 ListUserListGlobalLicenses 호출에서 시작일과 종료일이 설정된 경우에만 채워집니다.
user_list_id	int64 변경할 수 없습니다. 라이선스가 부여된 사용자 목록의 ID입니다.
license_type	UserListGlobalLicenseType 변경할 수 없습니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 제품 유형입니다.
status	UserListLicenseStatus 선택사항입니다. UserListGlobalLicense의 상태입니다(ENABLED 또는 DISABLED).

UserListGlobalLicenseCustomerInfo

사용자 목록 전역 라이선스의 고객에 관한 정보입니다. 고객이 전 세계 라이선스를 구매하면 시스템에서 자동으로 생성됩니다.

필드
name	string 식별자. 사용자 목록 전역 라이선스 고객의 리소스 이름입니다.
user_list_id	int64 출력 전용입니다. 라이선스가 부여된 사용자 목록의 ID입니다.
user_list_display_name	string 출력 전용입니다. 라이선스가 부여된 사용자 목록의 이름입니다.
license_type	UserListGlobalLicenseType 출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 제품 유형입니다.
status	UserListLicenseStatus 출력 전용입니다. UserListDirectLicense의 상태입니다(ENABLED 또는 DISABLED).
pricing	UserListLicensePricing 출력 전용입니다. UserListDirectLicense 가격 책정입니다.
client_account_type	UserListLicenseClientAccountType 출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 제품 유형입니다.
client_account_id	int64 출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 ID입니다.
client_account_display_name	string 출력 전용입니다. 사용자 목록에 라이선스가 부여된 클라이언트 고객의 이름입니다.
historical_pricings[]	UserListLicensePricing 출력 전용입니다. 이 사용자 목록 라이선스의 가격 책정 기록입니다.
metrics	UserListLicenseMetrics 출력 전용입니다. 이 라이선스와 관련된 측정항목 이 필드는 ListUserListGlobalLicenseCustomerInfos 호출에서 시작일과 종료일이 설정된 경우에만 채워집니다.

UserListGlobalLicenseType

사용자 목록 전역 라이선스 유형입니다.

열거형
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED	지정되지 않음
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER	리셀러 라이선스입니다.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE	DataMart 판매 측 라이선스입니다.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE	DataMart Buy Side 라이선스입니다.

UserListLicenseClientAccountType

사용자 목록 라이선스의 고객 계정 제품일 수 있습니다.

열거형
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN	알 수 없음
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS	Google Ads 고객
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER	Display & Video 360 파트너입니다.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER	Display & Video 360 광고주
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK	Google Ad Manager 잠재고객 링크입니다.

UserListLicenseMetrics

사용자 목록 라이선스와 관련된 측정항목입니다.

필드
click_count	int64 출력 전용입니다. 사용자 목록 라이선스의 클릭수입니다.
impression_count	int64 출력 전용입니다. 사용자 목록 라이선스의 노출수입니다.
revenue_usd_micros	int64 출력 전용입니다. 사용자 목록 라이선스의 수익입니다(미국 달러 기준 마이크로 단위).
start_date	int64 출력 전용입니다. YYYYMMDD 형식의 측정항목 시작일 (포함)입니다. 예를 들어 20260102는 2026년 1월 2일을 나타냅니다. 필터에 end_date가 사용된 경우 start_date도 필요합니다. start_date와 end_date이 모두 필터에 포함되지 않으면 UserListLicenseMetrics 필드가 응답에 채워지지 않습니다.
end_date	int64 출력 전용입니다. YYYYMMDD 형식의 측정항목 종료일 (포함)입니다. 예를 들어 20260102는 2026년 1월 2일을 나타냅니다. 필터에 start_date가 사용된 경우 end_date도 필요합니다. start_date와 end_date이 모두 필터에 포함되지 않으면 UserListLicenseMetrics 필드가 응답에 채워지지 않습니다.

UserListLicensePricing

사용자 목록 라이선스 가격입니다.

필드
pricing_id	int64 출력 전용입니다. 이 가격의 ID입니다.
start_time	Timestamp 출력 전용입니다. 가격의 시작 시간입니다.
end_time	Timestamp 선택사항입니다. 가격의 종료 시간입니다.
pricing_active	bool 출력 전용입니다. 이 가격이 활성 상태인지 여부입니다.
buyer_approval_state	UserListPricingBuyerApprovalState 출력 전용입니다. 이 가격의 구매자 승인 상태입니다. 이 필드는 읽기 전용입니다.
cost_micros	int64 선택사항입니다. currency_code 필드에 지정된 통화로 표시된 모델과 관련된 비용입니다(마이크로 단위(10^-6)). 예를 들어 currency_code이 USD인 경우 2000000은 $2를 의미합니다.
currency_code	string 선택사항입니다. 비용과 max_cost가 지정된 통화입니다. ISO 4217에 정의된 3자리 통화 코드여야 합니다.
cost_type	UserListPricingCostType 변경할 수 없습니다. 이 가격의 비용 유형입니다. create 작업에서만 설정할 수 있습니다. 기존 라이선스의 경우 업데이트할 수 없습니다.
max_cost_micros	int64 선택사항입니다. MEDIA_SHARE 비용 유형이 사용될 때 상거래 잠재고객에게 청구될 수 있는 최대 CPM입니다. 값은 마이크로 단위 (10^-6)이며 currency_code 필드로 지정된 통화입니다. 예를 들어 currency_code이 USD인 경우 2000000은 $2를 의미합니다. 이는 cost_type이 MEDIA_SHARE인 경우에만 관련이 있습니다. cost_type이 MEDIA_SHARE가 아닌데 이 필드가 설정되면 MAX_COST_NOT_ALLOWED 오류가 반환됩니다. 설정하지 않거나 0로 설정하면 한도가 없습니다.

UserListPricingBuyerApprovalState

사용자 목록 가격 책정 구매자 승인 상태입니다.

열거형
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED	지정되지 않음
PENDING	사용자 목록 클라이언트가 아직 사용자 목록 소유자가 설정한 가격 책정 약관에 동의하지 않았습니다.
APPROVED	사용자 목록 클라이언트가 사용자 목록 소유자가 설정한 가격 책정 약관에 동의했습니다.
REJECTED	사용자 목록 클라이언트가 사용자 목록 소유자가 설정한 가격 책정 약관을 거부했습니다.

UserListPricingCostType

사용자 목록 가격 책정 비용 유형입니다.

열거형
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED	지정되지 않음.
CPC	클릭당비용입니다.
CPM	1,000회 노출당비용
MEDIA_SHARE	미디어 공유

UserListLicenseStatus

사용자 목록 라이선스 상태입니다.

열거형
USER_LIST_LICENSE_STATUS_UNSPECIFIED	알 수 없음
USER_LIST_LICENSE_STATUS_ENABLED	활성 상태 - 사용자 목록에 라이선스가 계속 부여됩니다.
USER_LIST_LICENSE_STATUS_DISABLED	비활성 상태 - 사용자 목록에 더 이상 라이선스가 부여되지 않습니다.

UserProperties

이벤트가 발생한 시점에 광고주가 평가한 사용자에 관한 정보입니다. 자세한 내용은 https://support.google.com/google-ads/answer/14007601을 참고하세요.

필드
customer_type	CustomerType 선택사항입니다. 이벤트와 연결된 고객의 유형입니다.
customer_value_bucket	CustomerValueBucket 선택사항입니다. 광고주가 평가한 고객의 가치입니다.
additional_user_properties[]	UserProperty 선택사항입니다. 이 이벤트와 연결된 사용자의 추가 사용자 속성 버킷입니다.

UserProperty

이 이벤트와 연결된 사용자의 추가 사용자 속성 버킷입니다.

필드
property_name	string 필수 항목입니다. 사용할 사용자 속성의 이름입니다.
value	string 필수 항목입니다. 사용할 사용자 속성 값의 문자열 표현입니다.

WarningCount

특정 경고 이유에 대한 경고 수입니다.

필드
record_count	int64 경고가 있는 레코드 수입니다.
reason	ProcessingWarningReason 경고 이유입니다.

WarningInfo

각 유형의 경고 수입니다.

필드
warning_counts[]	WarningCount 경고 목록 및 경고 사유별 개수입니다.