Package google.ads.datamanager.v1

ดัชนี

• IngestionService (อินเทอร์เฟซ)
• MarketingDataInsightsService (อินเทอร์เฟซ)
• PartnerLinkService (อินเทอร์เฟซ)
• UserListDirectLicenseService (อินเทอร์เฟซ)
• UserListGlobalLicenseService (อินเทอร์เฟซ)
• UserListService (อินเทอร์เฟซ)
• AdEvent (ข้อความ)
• AdEvent.EventSubtype (enum)
• AdEvent.EventType (enum)
• AdFormat (enum)
• AdIdentifiers (ข้อความ)
• AdPlacement (enum)
• AdType (enum)
• AddressInfo (ข้อความ)
• AgeRange (enum)
• AttributionHint (enum)
• AudienceMember (ข้อความ)
• AwsWrappedKeyInfo (ข้อความ)
• AwsWrappedKeyInfo.KeyType (enum)
• Baseline (ข้อความ)
• Baseline.Location (ข้อความ)
• CartData (ข้อความ)
• CompositeData (ข้อความ)
• Consent (ข้อความ)
• ConsentStatus (enum)
• ContactIdInfo (ข้อความ)
• CoordinatorKeyInfo (ข้อความ)
• CreatePartnerLinkRequest (ข้อความ)
• CreateUserListDirectLicenseRequest (ข้อความ)
• CreateUserListGlobalLicenseRequest (ข้อความ)
• CreateUserListRequest (ข้อความ)
• CustomVariable (ข้อความ)
• CustomerType (enum)
• CustomerValueBucket (enum)
• DataSourceType (enum)
• DeletePartnerLinkRequest (ข้อความ)
• DeleteUserListRequest (ข้อความ)
• Destination (ข้อความ)
• DeviceInfo (ข้อความ)
• Encoding (enum)
• EncryptedUserId (ข้อความ)
• EncryptedUserId.EncryptionEntityType (enum)
• EncryptedUserId.EncryptionSource (enum)
• EncryptionInfo (ข้อความ)
• ErrorCount (ข้อความ)
• ErrorInfo (ข้อความ)
• ErrorReason (enum)
• Event (ข้อความ)
• EventLocation (ข้อความ)
• EventParameter (ข้อความ)
• EventSource (enum)
• ExperimentalField (ข้อความ)
• FeatureSet (enum)
• FieldWarning (ข้อความ)
• GcpWrappedKeyInfo (ข้อความ)
• GcpWrappedKeyInfo.KeyType (enum)
• Gender (enum)
• GetUserListDirectLicenseRequest (ข้อความ)
• GetUserListGlobalLicenseRequest (ข้อความ)
• GetUserListRequest (ข้อความ)
• GoogleUserIdData (ข้อความ)
• IngestAdEventsRequest (ข้อความ)
• IngestAdEventsResponse (ข้อความ)
• IngestAudienceMembersRequest (ข้อความ)
• IngestAudienceMembersResponse (ข้อความ)
• IngestEventsRequest (ข้อความ)
• IngestEventsResponse (ข้อความ)
• IngestedUserListInfo (ข้อความ)
• IngestedUserListInfo.UploadKeyType (enum)
• IpData (ข้อความ)
• Item (ข้อความ)
• ItemCustomVariable (ข้อความ)
• ItemParameter (ข้อความ)
• ListUserListDirectLicensesRequest (ข้อความ)
• ListUserListDirectLicensesResponse (ข้อความ)
• ListUserListGlobalLicenseCustomerInfosRequest (ข้อความ)
• ListUserListGlobalLicenseCustomerInfosResponse (ข้อความ)
• ListUserListGlobalLicensesRequest (ข้อความ)
• ListUserListGlobalLicensesResponse (ข้อความ)
• ListUserListsRequest (ข้อความ)
• ListUserListsResponse (ข้อความ)
• MatchRateRange (enum)
• MediaQuartile (enum)
• MobileData (ข้อความ)
• MobileIdInfo (ข้อความ)
• MobileIdInfo.KeySpace (enum)
• PairData (ข้อความ)
• PairIdInfo (ข้อความ)
• PartnerAudienceInfo (ข้อความ)
• PartnerAudienceInfo.PartnerAudienceSource (enum)
• PartnerCustomerAccount (ข้อความ)
• PartnerLink (ข้อความ)
• PartnerLinkMetadata (ข้อความ)
• PartnerProvidedIdData (ข้อความ)
• Platform (enum)
• PlatformType (enum)
• PpidData (ข้อความ)
• ProcessingErrorReason (enum)
• ProcessingWarningReason (enum)
• Product (enum) (เลิกใช้งานแล้ว)
• ProductAccount (ข้อความ)
• ProductAccount.AccountType (enum)
• PseudonymousIdInfo (ข้อความ)
• PseudonymousIdInfo.SyncStatus (enum)
• RemoveAllAudienceMembersRequest (ข้อความ)
• RemoveAllAudienceMembersResponse (ข้อความ)
• RemoveAudienceMembersRequest (ข้อความ)
• RemoveAudienceMembersResponse (ข้อความ)
• RequestStatusPerDestination (ข้อความ)
• RequestStatusPerDestination.DataType (enum)
• RequestStatusPerDestination.DataTypeCount (ข้อความ)
• RequestStatusPerDestination.IngestAudienceMembersStatus (ข้อความ)
• RequestStatusPerDestination.IngestCompositeDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestEventsStatus (ข้อความ)
• RequestStatusPerDestination.IngestGoogleUserIdDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestMobileDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestPairDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestPartnerProvidedIdDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestPpidDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestUserDataStatus (ข้อความ)
• RequestStatusPerDestination.IngestUserIdDataStatus (ข้อความ)
• RequestStatusPerDestination.RemoveAllAudienceMembersStatus (ข้อความ)
• RequestStatusPerDestination.RemoveAudienceMembersStatus (ข้อความ)
• RequestStatusPerDestination.RemoveCompositeDataStatus (ข้อความ)
• RequestStatusPerDestination.RemoveGoogleUserIdDataStatus (ข้อความ)
• RequestStatusPerDestination.RemoveMobileDataStatus (ข้อความ)
• RequestStatusPerDestination.RemovePairDataStatus (ข้อความ)
• RequestStatusPerDestination.RemovePartnerProvidedIdDataStatus (ข้อความ)
• RequestStatusPerDestination.RemovePpidDataStatus (ข้อความ)
• RequestStatusPerDestination.RemoveUserDataStatus (ข้อความ)
• RequestStatusPerDestination.RemoveUserIdDataStatus (ข้อความ)
• RequestStatusPerDestination.RequestStatus (enum)
• RetrieveInsightsRequest (ข้อความ)
• RetrieveInsightsResponse (ข้อความ)
• RetrieveInsightsResponse.MarketingDataInsight (ข้อความ)
• RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension (enum)
• RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute (ข้อความ)
• RetrieveRequestStatusRequest (ข้อความ)
• RetrieveRequestStatusResponse (ข้อความ)
• SearchPartnerLinksRequest (ข้อความ)
• SearchPartnerLinksResponse (ข้อความ)
• SizeInfo (ข้อความ)
• TargetNetworkInfo (ข้อความ)
• TargetingType (enum)
• TermsOfService (ข้อความ)
• TermsOfServiceStatus (enum)
• UpdateUserListDirectLicenseRequest (ข้อความ)
• UpdateUserListGlobalLicenseRequest (ข้อความ)
• UpdateUserListRequest (ข้อความ)
• UserData (ข้อความ)
• UserIdData (ข้อความ)
• UserIdInfo (ข้อความ)
• UserIdentifier (ข้อความ)
• UserList (ข้อความ)
• UserList.AccessReason (enum)
• UserList.AccessStatus (enum)
• UserList.ClosingReason (enum)
• UserList.MembershipStatus (enum)
• UserListDirectLicense (ข้อความ)
• UserListGlobalLicense (ข้อความ)
• UserListGlobalLicenseCustomerInfo (ข้อความ)
• UserListGlobalLicenseType (enum)
• UserListLicenseClientAccountType (enum)
• UserListLicenseMetrics (ข้อความ)
• UserListLicensePricing (ข้อความ)
• UserListLicensePricing.UserListPricingBuyerApprovalState (enum)
• UserListLicensePricing.UserListPricingCostType (enum)
• UserListLicenseStatus (enum)
• UserProperties (ข้อความ)
• UserProperty (ข้อความ)
• ViewType (enum)
• ViewabilityInfo (ข้อความ)
• WarningCount (ข้อความ)
• WarningInfo (ข้อความ)
• WarningReason (enum)

IngestionService

บริการสําหรับการส่งข้อมูลกลุ่มเป้าหมายไปยังปลายทางที่รองรับ

IngestAdEvents
rpc IngestAdEvents(IngestAdEventsRequest) returns (IngestAdEventsResponse) อัปโหลดรายการAdEventไปยัง Google Analytics ฟีเจอร์นี้พร้อมใช้งานสำหรับบัญชีในรายการที่อนุญาตเท่านั้น ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/datamanager

IngestAudienceMembers
rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse) อัปโหลดรายการAudienceMemberไปยัง Destination ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/datamanager

IngestEvents
rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse) อัปโหลดรายการทรัพยากร Event จาก Destination ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/datamanager

RemoveAllAudienceMembers
rpc RemoveAllAudienceMembers(RemoveAllAudienceMembersRequest) returns (RemoveAllAudienceMembersResponse) นำสมาชิกในกลุ่มเป้าหมายทั้งหมดออกจากปลายทางที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/datamanager

RemoveAudienceMembers
rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse) นำรายการทรัพยากร AudienceMember ออกจาก Destination ที่ระบุ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth ต่อไปนี้ https://www.googleapis.com/auth/datamanager

RetrieveRequestStatus
rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse) รับสถานะของคำขอที่ระบุรหัสคำขอ ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต 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} ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้ https://www.googleapis.com/auth/datamanager https://www.googleapis.com/auth/datamanager.partnerlink

DeletePartnerLink

rpc DeletePartnerLink(DeletePartnerLinkRequest) returns (Empty) ลบลิงก์พาร์ทเนอร์สำหรับบัญชีที่ระบุ ส่วนหัวการให้สิทธิ์: เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId} ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้ https://www.googleapis.com/auth/datamanager https://www.googleapis.com/auth/datamanager.partnerlink

SearchPartnerLinks

rpc SearchPartnerLinks(SearchPartnerLinksRequest) returns (SearchPartnerLinksResponse) ค้นหาลิงก์พาร์ทเนอร์ทั้งหมดที่ไปยังและมาจากบัญชีที่ระบุ ส่วนหัวการให้สิทธิ์: เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId} ขอบเขตการให้สิทธิ์ ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้ https://www.googleapis.com/auth/datamanager https://www.googleapis.com/auth/datamanager.partnerlink

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

AdEvent

เหตุการณ์โฆษณา

ช่อง
advertiser_id	string ต้องระบุ รหัสของผู้ลงโฆษณาสำหรับเหตุการณ์โฆษณา โดยต้องตรงกับรหัสที่ส่งในขั้นตอนการลิงก์
event_type	EventType ต้องระบุ ประเภทของเหตุการณ์
timestamp	Timestamp ต้องระบุ เวลาที่เกิดเหตุการณ์
event_id	string ไม่บังคับ รหัสที่ผู้โทรสร้างและจัดการซึ่งระบุเหตุการณ์นี้โดยไม่ซ้ำกัน ต้องระบุหากต้องการขจัดเหตุการณ์โฆษณาที่ซ้ำกันซึ่งรวมอยู่ในคำขอหลายรายการ หรือจะเว้นช่องนี้ว่างไว้ก็ได้
user_data	UserData ไม่บังคับ ข้อมูลที่ได้จากผู้ใช้หลายรายการซึ่งแสดงถึงผู้ใช้ที่เชื่อมโยงกับเหตุการณ์ คุณสามารถระบุข้อมูลประเภทเดียวกันได้หลายอินสแตนซ์ (เช่น อีเมล) ยิ่งให้ข้อมูลมากเท่าใด ก็ยิ่งมีโอกาสพบรายการที่ตรงกันมากขึ้นเท่านั้น
device_info	DeviceInfo ต้องระบุ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้เมื่อเกิดเหตุการณ์โฆษณา
ip_address	string ไม่บังคับ ที่อยู่ IP ที่ใช้สำหรับการวัดผล ค่านี้ต้องเหมือนกับ DeviceInfo.ip_address เว้นว่างไว้หากไม่ต้องการแชร์ IP เพื่อการวัดผล
mobile_device_id	string ไม่บังคับ รหัสอุปกรณ์ของอุปกรณ์ที่โฆษณาแสดง
campaign_id	string ต้องระบุ รหัสของแคมเปญที่เชื่อมโยง
campaign_name	string ต้องระบุ ชื่อแคมเปญที่เชื่อมโยง
ad_group_id	string ไม่บังคับ รหัสของกลุ่มโฆษณาที่เชื่อมโยง
ad_id	string ไม่บังคับ รหัสของโฆษณาที่เชื่อมโยงภายในกลุ่ม
ad_height	int32 ไม่บังคับ ความสูงของโฆษณาในหน่วยพิกเซล
ad_width	int32 ไม่บังคับ ความกว้างของโฆษณาในหน่วยพิกเซล
region_code	string ไม่บังคับ ประเทศและเขตย่อยตามมาตรฐาน ISO 3166-2
source	string ต้องระบุ แหล่งที่มาของแพลตฟอร์มของโฆษณา ซึ่งคล้ายกับแหล่งที่มาของ Google Analytics
medium	string ต้องระบุ สื่อของโฆษณา ซึ่งคล้ายกับสื่อของ Google Analytics
attribution_hint	AttributionHint ไม่บังคับ สถานะการระบุแหล่งที่มาที่พาร์ทเนอร์ถือว่ามีสำหรับเหตุการณ์โฆษณานี้ ซึ่งจะทําหน้าที่เป็นเพียงสัญญาณสําหรับวิธีที่พาร์ทเนอร์สันนิษฐานว่าการระบุแหล่งที่มาทํางาน และไม่ได้บังคับให้ผลลัพธ์สุดท้ายปรากฏในรายงานขั้นสุดท้าย
viewability_info	ViewabilityInfo ต้องระบุ รายละเอียดการมองเห็นโฆษณาที่แสดง
ฟิลด์ Union event_subtype_oneof ไม่บังคับ การแยกประเภทเพิ่มเติมเกี่ยวกับประเภทเหตุการณ์โฆษณา ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum event_subtype_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
event_subtype	EventSubtype ค่า Enum สำหรับประเภทย่อยของกิจกรรม
event_subtype_string	string ค่าสตริงสําหรับประเภทย่อยของเหตุการณ์
ฟิลด์ Union ad_type_oneof ไม่บังคับ ประเภทโฆษณาที่แสดง ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum ad_type_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
ad_type	AdType ค่า Enum สำหรับประเภทโฆษณา
ad_type_string	string ค่าสตริงสำหรับประเภทโฆษณา
ฟิลด์ Union ad_format_oneof ไม่บังคับ ประเภทโฆษณาที่แสดง ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum ad_format_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
ad_format	AdFormat ค่า Enum สำหรับรูปแบบโฆษณา
ad_format_string	string ค่าสตริงสำหรับรูปแบบโฆษณา
ฟิลด์ Union ad_placement_oneof ไม่บังคับ ตําแหน่งของโฆษณาที่แสดง ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum ad_placement_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
ad_placement	AdPlacement ค่า Enum สำหรับตําแหน่งโฆษณา
ad_placement_string	string ค่าสตริงสำหรับตําแหน่งโฆษณา
ฟิลด์ Union targeting_type_oneof ไม่บังคับ ประเภทของการกำหนดเป้าหมายที่ใช้ในการแสดงโฆษณา ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum targeting_type_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
targeting_type	TargetingType ค่า Enum สำหรับประเภทการกำหนดเป้าหมาย
targeting_type_string	string ค่าสตริงสำหรับประเภทการกำหนดเป้าหมาย
ฟิลด์ Union platform_type_oneof ไม่บังคับ ประเภทของแพลตฟอร์มที่แสดงโฆษณา ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum platform_type_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
platform_type	PlatformType ค่า Enum สำหรับประเภทแพลตฟอร์ม
platform_type_string	string ค่าสตริงสำหรับประเภทแพลตฟอร์ม
ฟิลด์ Union platform_oneof ไม่บังคับ รายละเอียดเพิ่มเติมของแพลตฟอร์มที่แสดงโฆษณา ระบบยอมรับสตริงดิบเพื่อจัดการค่าอื่นๆ นอกเหนือจาก Enum ที่แท้จริง หากเป็นไปได้ ให้ใช้ Enum platform_oneof ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
platform	Platform ค่า Enum สำหรับแพลตฟอร์ม
platform_string	string ค่าสตริงสำหรับแพลตฟอร์ม
measurement_allowed	bool ไม่บังคับ แสดงว่าอนุญาตให้ใช้แถวเพื่อวัตถุประสงค์ในการวัดผลหรือไม่ ตามที่กฎหมายว่าด้วยความเป็นส่วนตัวที่เกี่ยวข้องกำหนดภายในเขตอำนาจศาลระดับภูมิภาค

EventSubtype

การแยกประเภทเพิ่มเติมเกี่ยวกับประเภทเหตุการณ์โฆษณา

Enum
EVENT_SUBTYPE_UNSPECIFIED	ประเภทย่อยของเหตุการณ์ที่ไม่ได้ระบุ
EVENT_SUBTYPE_IMPRESSION	เหตุการณ์การแสดงผล
EVENT_SUBTYPE_ENGAGED_VIEW	เหตุการณ์การดูอย่างมีส่วนร่วม
EVENT_SUBTYPE_ONSITE_CLICK	กิจกรรมการคลิกในเว็บไซต์
EVENT_SUBTYPE_OUTBOUND_CLICK	กิจกรรมการคลิกขาออก

EventType

ประเภทของเหตุการณ์

Enum
EVENT_TYPE_UNSPECIFIED	ประเภทเหตุการณ์ที่ไม่ได้ระบุ
EVENT_TYPE_VIEW	ดูกิจกรรม
EVENT_TYPE_CLICK	กิจกรรมการคลิก

AdFormat

รูปแบบของโฆษณาที่แสดง

Enum
AD_FORMAT_UNSPECIFIED	รูปแบบโฆษณาที่ไม่ได้ระบุ
AD_FORMAT_AR	โฆษณา AR
AD_FORMAT_AUDIO	โฆษณาเสียง
AD_FORMAT_BANNER	โฆษณาแบนเนอร์
AD_FORMAT_BUMPER	โฆษณาบัมเปอร์
AD_FORMAT_CAROUSEL	โฆษณา Carousel
AD_FORMAT_COLLECTION	โฆษณาคอลเล็กชัน
AD_FORMAT_IMAGE	โฆษณาแบบรูปภาพ
AD_FORMAT_INTERACTIVE	โฆษณาแบบอินเทอร์แอกทีฟ
AD_FORMAT_INTERSTITIAL	โฆษณาคั่นระหว่างหน้า
AD_FORMAT_IN_FEED	โฆษณาในฟีด
AD_FORMAT_IN_STREAM	โฆษณาในสตรีม
AD_FORMAT_IN_STREAM_SKIPPABLE	โฆษณาในสตรีมแบบข้ามได้
AD_FORMAT_IN_STREAM_NON_SKIPPABLE	โฆษณาในสตรีมแบบข้ามไม่ได้
AD_FORMAT_NATIVE	โฆษณาเนทีฟ
AD_FORMAT_SHORTS	โฆษณา Shorts
AD_FORMAT_STORY	โฆษณาแบบเล่าเรื่อง
AD_FORMAT_SPONSORED	โฆษณาที่ได้รับการสนับสนุน
AD_FORMAT_VIDEO	โฆษณาวิดีโอ

AdIdentifiers

ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา)

ช่อง
session_attributes	string ไม่บังคับ แอตทริบิวต์เซสชันสําหรับการระบุแหล่งที่มาและการประมาณเหตุการณ์
gclid	string ไม่บังคับ Google Click ID (gclid) ที่เชื่อมโยงกับเหตุการณ์นี้
gbraid	string ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์ของแอปและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
wbraid	string ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์บนเว็บและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
landing_page_device_info	DeviceInfo ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) ในขณะที่เข้าสู่เว็บไซต์ของผู้ลงโฆษณาหลังจากโต้ตอบกับโฆษณา
mobile_device_id	string ไม่บังคับ ตัวระบุบนมือถือสำหรับผู้ลงโฆษณา ซึ่งจะเป็น IDFA ใน iOS, AdID ใน Android หรือตัวระบุของผู้ลงโฆษณาของแพลตฟอร์มอื่นๆ
dclid	string ไม่บังคับ รหัสคลิกที่แสดงที่เชื่อมโยงกับเหตุการณ์นี้
impression_id	string ไม่บังคับ รหัสการแสดงผลที่เชื่อมโยงกับเหตุการณ์นี้
match_id	string ไม่บังคับ ฟิลด์รหัสการจับคู่ที่ใช้เพื่อเชื่อมโยงเหตุการณ์นี้กับเหตุการณ์ก่อนหน้า
encrypted_user_ids[]	EncryptedUserId ไม่บังคับ รหัสผู้ใช้ที่เข้ารหัสจำนวนเท่าใดก็ได้
ppid	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ (ลงชื่อเข้าใช้) ตามที่ผู้เผยแพร่โฆษณากำหนด
visitor_ppid	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ที่ไม่ได้รับการตรวจสอบสิทธิ์ (ผู้ใช้ที่ไม่ได้ลงชื่อเข้าใช้) ตามที่ผู้เผยแพร่โฆษณากำหนด

AdPlacement

ตําแหน่งของโฆษณาที่แสดง

Enum
AD_PLACEMENT_UNSPECIFIED	ตำแหน่งโฆษณาที่ไม่ระบุ
AD_PLACEMENT_DISCOVER	ค้นพบตำแหน่ง
AD_PLACEMENT_FEED	การจัดวางฟีด
AD_PLACEMENT_FOOTER	ตำแหน่งของส่วนท้าย
AD_PLACEMENT_HEADER	ตำแหน่งส่วนหัว
AD_PLACEMENT_HOME	ตำแหน่งในหน้าแรก
AD_PLACEMENT_IN_CONTENT	ตําแหน่งในเนื้อหา
AD_PLACEMENT_PROMOTED	ตำแหน่งที่โปรโมต
AD_PLACEMENT_SEARCH	ตำแหน่งโฆษณา Search
AD_PLACEMENT_STORY	ตำแหน่งของเรื่องราว

AdType

ประเภทโฆษณาที่แสดง

Enum
AD_TYPE_UNSPECIFIED	ประเภทโฆษณาที่ไม่ได้ระบุ
AD_TYPE_DISPLAY	โฆษณา Display
AD_TYPE_TEXT	โฆษณาแบบข้อความ
AD_TYPE_IMAGE	โฆษณาแบบรูปภาพ
AD_TYPE_RICH_MEDIA	โฆษณาแบบริชมีเดีย
AD_TYPE_HTML	โฆษณา HTML
AD_TYPE_AUDIO	โฆษณาเสียง
AD_TYPE_VIDEO	โฆษณาวิดีโอ

AddressInfo

ข้อมูลที่อยู่ของผู้ใช้

ช่อง
given_name	string ต้องระบุ ชื่อ (ชื่อแรก) ของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
family_name	string ต้องระบุ นามสกุลของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
region_code	string ต้องระบุ รหัสภูมิภาค 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 alpha-2 ของที่อยู่ผู้ใช้
postal_code	string ต้องระบุ รหัสไปรษณีย์ของที่อยู่ผู้ใช้
address_line	string ไม่บังคับ ถนนและหมายเลขที่อยู่ของผู้ใช้ ใช้สําหรับ Google Analytics เท่านั้น ฟิลด์นี้จะได้รับการแฮชและอาจได้รับการเข้ารหัส แปลงค่าเป็นรูปแบบมาตรฐานก่อนแฮช นำอักขระสัญลักษณ์ออก แปลงเป็นตัวพิมพ์เล็ก นำช่องว่างขึ้นต้นและต่อท้ายออก
city	string ไม่บังคับ เมืองของที่อยู่ผู้ใช้ ใช้สําหรับ Google Analytics เท่านั้น ค่าควรได้รับการทำให้เป็นปกติดังนี้ นำอักขระสัญลักษณ์ออก แปลงเป็นตัวพิมพ์เล็ก นำช่องว่างขึ้นต้นและต่อท้ายออก
administrative_area	string ไม่บังคับ เขตบริหาร (รัฐ/จังหวัด) ของที่อยู่ของผู้ใช้ ใช้สําหรับ Google Analytics เท่านั้น ค่าควรได้รับการทำให้เป็นปกติดังนี้ นำอักขระสัญลักษณ์ออก แปลงเป็นตัวพิมพ์เล็ก นำช่องว่างขึ้นต้นและต่อท้ายออก

ช่วงอายุ

ช่วงอายุตามข้อมูลประชากร

Enum
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 ปีขึ้นไป

AttributionHint

สถานะการระบุแหล่งที่มาที่พาร์ทเนอร์ถือว่ามีสำหรับเหตุการณ์โฆษณานี้

Enum
ATTRIBUTION_HINT_UNSPECIFIED	สถานะการระบุแหล่งที่มาที่ไม่รู้จัก
ATTRIBUTION_HINT_CONVERTED	สถานะที่แปลงแล้ว
ATTRIBUTION_HINT_NOT_CONVERTED	สถานะ "ยังไม่ได้แปลง"

AudienceMember

สมาชิกในกลุ่มเป้าหมายที่จะดำเนินการ

ช่อง
destination_references[]	string ไม่บังคับ กำหนดว่าควรส่งสมาชิกในกลุ่มเป้าหมายไปยัง Destination ใด
consent	Consent ไม่บังคับ การตั้งค่าความยินยอมสำหรับผู้ใช้
ฟิลด์ Union data ประเภทของข้อมูลระบุตัวตนที่จะดำเนินการ data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
user_data	UserData ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้
pair_data	PairData รหัส Publisher Advertiser Identity Reconciliation (PAIR) ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น
mobile_data	MobileData ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่ของผู้ใช้
user_id_data	UserIdData ข้อมูลที่เกี่ยวข้องกับตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด
ppid_data	PpidData ข้อมูลที่เกี่ยวข้องกับตัวระบุที่ผู้เผยแพร่โฆษณามีให้ ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น
composite_data	CompositeData กลุ่มของตัวระบุหลายประเภท
google_user_id_data	GoogleUserIdData รหัสผู้ใช้ Google ที่เข้ารหัส
partner_provided_id_data	PartnerProvidedIdData ตัวระบุที่พาร์ทเนอร์ระบุ

AwsWrappedKeyInfo

คีย์การเข้ารหัสข้อมูลที่ปกปิดด้วยคีย์ AWS KMS

ช่อง
key_type	KeyType ต้องระบุ ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล
role_arn	string ต้องระบุ ชื่อทรัพยากร Amazon ของบทบาท IAM ที่จะใช้สำหรับการเข้าถึงการถอดรหัส KMS ควรอยู่ในรูปแบบ arn:{partition}:iam::{account_id}:role/{role_name}
kek_uri	string ต้องระบุ URI ของคีย์ AWS KMS ที่ใช้ในการถอดรหัส DEK ควรอยู่ในรูปแบบ 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

ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล

Enum
KEY_TYPE_UNSPECIFIED	ประเภทคีย์ที่ไม่ได้ระบุ ไม่ควรใช้
XCHACHA20_POLY1305	อัลกอริทึม XChaCha20-Poly1305

ฐาน

เกณฑ์พื้นฐานที่ใช้เปรียบเทียบข้อมูลเชิงลึก

ช่อง
ฟิลด์ Union baseline สถานที่ตั้งพื้นฐานที่ใช้เปรียบเทียบข้อมูลเชิงลึก baseline ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
baseline_location	Location ตำแหน่งพื้นฐานของคำขอ ตำแหน่งพื้นฐานคือรายการ OR ของภูมิภาคที่ขอ
location_auto_detection_enabled	bool หากตั้งค่าเป็นจริง บริการจะพยายามตรวจหาตำแหน่งพื้นฐานสำหรับข้อมูลเชิงลึกโดยอัตโนมัติ

ตำแหน่ง

ตำแหน่งพื้นฐานของคำขอ ตำแหน่งพื้นฐานอยู่ในรายการ OR ของรหัสภูมิภาค ISO 3166-1 alpha-2 ของภูมิภาคที่ขอ

ช่อง
region_codes[]	string รายการรหัสภูมิภาค ISO 3166-1 alpha-2

CartData

ข้อมูลรถเข็นช็อปปิ้งที่เชื่อมโยงกับเหตุการณ์

ช่อง
merchant_id	string ไม่บังคับ รหัส Merchant Center ที่เชื่อมโยงกับสินค้า
merchant_feed_label	string ไม่บังคับ ป้ายกำกับฟีด Merchant Center ที่เชื่อมโยงกับฟีดของสินค้า
merchant_feed_language_code	string ไม่บังคับ รหัสภาษาใน ISO 639-1 ที่เชื่อมโยงกับฟีด Merchant Center ของสินค้าที่มีการอัปโหลด
transaction_discount	double ไม่บังคับ ยอดรวมของส่วนลดทั้งหมดที่เชื่อมโยงกับธุรกรรม
items[]	Item ไม่บังคับ รายการสินค้าที่เชื่อมโยงกับกิจกรรม
coupon_codes[]	string ไม่บังคับ รายการรหัสคูปองที่ใช้กับรถเข็น รหัสคูปองระดับรถเข็นและระดับสินค้าจะแยกกัน หากเหตุการณ์มีปลายทางเป็น Google Analytics ให้ระบุรหัสคูปองเพียงรหัสเดียว Google Analytics จะไม่สนใจรหัสคูปองเพิ่มเติม

CompositeData

ข้อมูลแบบผสมที่มีตัวระบุและข้อมูลที่เชื่อมโยงสำหรับผู้ใช้ ต้องระบุ user_data หรือ ip_data อย่างน้อย 1 รายการ

ช่อง
user_data	UserData ไม่บังคับ ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้
ip_data[]	IpData ไม่บังคับ ข้อมูลที่อยู่ IP ที่แสดงถึงการโต้ตอบของลูกค้าซึ่งใช้ในการสร้างกลุ่มเป้าหมาย

ความยินยอม

การตั้งค่าความยินยอมตามกฎหมายตลาดดิจิทัล (DMA) สำหรับผู้ใช้

ช่อง
ad_user_data	ConsentStatus ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ใช้ข้อมูลผู้ใช้ของโฆษณาหรือไม่
ad_personalization	ConsentStatus ไม่บังคับ แสดงว่าผู้ใช้ยินยอมให้ปรับโฆษณาตามโปรไฟล์ของผู้ใช้หรือไม่

ConsentStatus

แสดงว่าผู้ใช้ให้ ปฏิเสธ หรือไม่ได้ระบุความยินยอม

Enum
CONSENT_STATUS_UNSPECIFIED	ไม่ได้ระบุ
CONSENT_GRANTED	ให้สิทธิ์แล้ว
CONSENT_DENIED	ถูกปฏิเสธ

ContactIdInfo

ข้อมูลเพิ่มเติมเมื่อ CONTACT_ID เป็นหนึ่งใน upload_key_types

ช่อง
match_rate_percentage	int32 เอาต์พุตเท่านั้น อัตราการจับคู่สำหรับกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า
data_source_type	DataSourceType ไม่บังคับ เปลี่ยนแปลงไม่ได้ แหล่งที่มาของข้อมูลการอัปโหลด

CoordinatorKeyInfo

ข้อมูลเกี่ยวกับคีย์ผู้ประสานงาน

ช่อง
key_id	string ต้องระบุ รหัสของคีย์ผู้ประสานงานที่เลือก

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 ไม่บังคับ หากเป็นจริง ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ

ตัวแปรที่กำหนดเอง

ตัวแปรที่กำหนดเองสำหรับ Conversion ของโฆษณา

ช่อง
variable	string ไม่บังคับ ชื่อของตัวแปรที่กำหนดเองที่จะตั้งค่า หากไม่พบตัวแปรสำหรับปลายทางที่ระบุ ระบบจะไม่สนใจตัวแปรนั้น
value	string ไม่บังคับ ค่าที่จะจัดเก็บสำหรับตัวแปรที่กำหนดเอง
destination_references[]	string ไม่บังคับ สตริงอ้างอิงที่ใช้เพื่อกำหนดว่าควรส่งตัวแปรที่กำหนดเองไปยัง Event.destination_references ใด หากเว้นว่าง ระบบจะใช้ Event.destination_references

CustomerType

ประเภทลูกค้าที่เชื่อมโยงกับเหตุการณ์

Enum
CUSTOMER_TYPE_UNSPECIFIED	ไม่ได้ระบุ CustomerType ไม่ควรใช้
NEW	ลูกค้าเป็นลูกค้าใหม่ของผู้ลงโฆษณา
RETURNING	ลูกค้ากลับมาหาผู้ลงโฆษณา
REENGAGED	ลูกค้ากลับมามีส่วนร่วมกับผู้ลงโฆษณาอีกครั้ง

CustomerValueBucket

มูลค่าของลูกค้าที่ผู้ลงโฆษณาประเมิน

Enum
CUSTOMER_VALUE_BUCKET_UNSPECIFIED	Unspecified CustomerValueBucket ไม่ควรใช้
LOW	ลูกค้ามีคุณค่าต่ำ
MEDIUM	ลูกค้ามีคุณค่าปานกลาง
HIGH	ลูกค้ามีคุณค่าสูง

DataSourceType

ระบุแหล่งที่มาของข้อมูลการอัปโหลด

Enum
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 ไม่บังคับ หากเป็นจริง ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ

ปลายทาง

ผลิตภัณฑ์ Google ที่คุณส่งข้อมูลไปให้ เช่น บัญชี Google Ads

ช่อง
reference	string ไม่บังคับ รหัสสำหรับทรัพยากร Destination นี้ ซึ่งไม่ซ้ำกันภายในคำขอ ใช้เพื่ออ้างอิงถึง Destination นี้ใน IngestEventsRequest และ IngestAudienceMembersRequest
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, รหัสกลุ่มเป้าหมาย Display & Video 360 หรือรหัสการกระทําที่ถือเป็น Conversion ของ Google Ads ช่องนี้ไม่บังคับสำหรับการนําเข้าเหตุการณ์ของ Google Ad Manager และการนําเข้าผู้ใช้ ต้องระบุสำหรับกรณีการใช้งานอื่นๆ ทั้งหมด

DeviceInfo

ข้อมูลเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์

ช่อง
user_agent	string ไม่บังคับ สตริง User Agent ของอุปกรณ์สำหรับบริบทที่ระบุ
ip_address	string ไม่บังคับ ที่อยู่ IP ของอุปกรณ์สำหรับบริบทที่ระบุ ต้องระบุเมื่อใช้ใน AdEvent สำหรับการตรวจสอบทางภูมิศาสตร์
category	string ไม่บังคับ หมวดหมู่ของอุปกรณ์ เช่น "เดสก์ท็อป" "แท็บเล็ต" "อุปกรณ์เคลื่อนที่" "สมาร์ททีวี"
language_code	string ไม่บังคับ ภาษาที่อุปกรณ์ใช้ในรูปแบบ ISO 639-1
screen_height	int32 ไม่บังคับ ความสูงของหน้าจอในหน่วยพิกเซล
screen_width	int32 ไม่บังคับ ความกว้างของหน้าจอในหน่วยพิกเซล
operating_system	string ไม่บังคับ ระบบปฏิบัติการหรือแพลตฟอร์มของอุปกรณ์
operating_system_version	string ไม่บังคับ เวอร์ชันของระบบปฏิบัติการหรือแพลตฟอร์ม
model	string ไม่บังคับ รุ่นของอุปกรณ์
brand	string ไม่บังคับ แบรนด์ของอุปกรณ์
browser	string ไม่บังคับ แบรนด์หรือประเภทของเบราว์เซอร์
browser_version	string ไม่บังคับ เวอร์ชันของเบราว์เซอร์

การเข้ารหัส

ประเภทการเข้ารหัสของข้อมูลระบุตัวบุคคลที่แฮช

Enum
ENCODING_UNSPECIFIED	ประเภทการเข้ารหัสที่ไม่ได้ระบุ ไม่ควรใช้
HEX	การเข้ารหัสฐาน 16
BASE64	การเข้ารหัส Base 64

EncryptedUserId

ตัวระบุผู้ใช้ที่ออกให้เพื่อใช้สำหรับการระบุแหล่งที่มา ต้องกรอกข้อมูลทุกช่องหากใช้ฟีเจอร์นี้

ช่อง
encrypted_id	string ต้องระบุ รหัสที่เข้ารหัสซึ่งเป็นตัวอักษรและตัวเลขคละกัน
entity_type	EncryptionEntityType ต้องระบุ ประเภทเอนทิตีการเข้ารหัส ซึ่งควรตรงกับการกำหนดค่าการเข้ารหัสสำหรับการแสดงโฆษณาหรือการโอนข้อมูล
entity_id	int64 ต้องระบุ รหัสเอนทิตีการเข้ารหัส ซึ่งควรตรงกับการกำหนดค่าการเข้ารหัสสำหรับการแสดงโฆษณาหรือการโอนข้อมูล
source	EncryptionSource ต้องระบุ อธิบายว่าได้รับคุกกี้ที่เข้ารหัสจากการแสดงโฆษณา (มาโคร %m) หรือจากการโอนข้อมูล

EncryptionEntityType

ประเภทเอนทิตีการเข้ารหัส

Enum
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED	ประเภทเอนทิตีการเข้ารหัสที่ไม่ได้ระบุ
CAMPAIGN_MANAGER_ACCOUNT	บัญชี Campaign Manager 360
CAMPAIGN_MANAGER_ADVERTISER	ผู้ลงโฆษณา Campaign Manager 360
DISPLAY_VIDEO_PARTNER	พาร์ทเนอร์ Display & Video 360
DISPLAY_VIDEO_ADVERTISER	ผู้ลงโฆษณา Display & Video 360
GOOGLE_ADS_CUSTOMER	ลูกค้า Google Ads
GOOGLE_AD_MANAGER_NETWORK_CODE	รหัสเครือข่าย Ad Manager ของ Google

EncryptionSource

แหล่งที่มาของการเข้ารหัส

Enum
ENCRYPTION_SOURCE_UNSPECIFIED	แหล่งที่มาของการเข้ารหัสที่ไม่ได้ระบุ
AD_SERVING	แหล่งที่มาของการเข้ารหัสการแสดงโฆษณา
DATA_TRANSFER	แหล่งที่มาของการเข้ารหัสการโอนข้อมูล

EncryptionInfo

ข้อมูลการเข้ารหัสสำหรับข้อมูลที่กำลังส่งผ่านข้อมูล

ช่อง
ฟิลด์ Union wrapped_key คีย์ที่ห่อที่ใช้เข้ารหัสข้อมูล wrapped_key ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
gcp_wrapped_key_info	GcpWrappedKeyInfo ข้อมูลคีย์ที่ปกปิดของ Google Cloud Platform
aws_wrapped_key_info	AwsWrappedKeyInfo ข้อมูลคีย์ที่ปกปิดของ Amazon Web Services
coordinator_key_info	CoordinatorKeyInfo ข้อมูลสำคัญสำหรับคีย์ผู้ประสานงานที่เลือก ไม่รองรับสำหรับเมธอด IngestEvents, IngestAudienceMembers และ RemoveAudienceMembers

ErrorCount

จำนวนข้อผิดพลาดสำหรับสาเหตุของข้อผิดพลาดที่ระบุ

ช่อง
record_count	int64 จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ
reason	ProcessingErrorReason เหตุผลของข้อผิดพลาดของระเบียนที่ไม่สำเร็จ

ErrorInfo

จำนวนข้อผิดพลาดสำหรับข้อผิดพลาดแต่ละประเภท

ช่อง
error_counts[]	ErrorCount รายการข้อผิดพลาดและจำนวนตามเหตุผลของข้อผิดพลาด อาจไม่แสดงในบางกรณี

ErrorReason

สาเหตุของข้อผิดพลาดสำหรับ Data Manager API หมายเหตุ: Enum นี้ยังไม่คงที่และอาจมีการเพิ่มค่าใหม่ในอนาคต

Enum
ERROR_REASON_UNSPECIFIED	อย่าใช้ค่าเริ่มต้นนี้
INTERNAL_ERROR	เกิดข้อผิดพลาดภายใน
DEADLINE_EXCEEDED	คำขอใช้เวลาตอบสนองนานเกินไป
RESOURCE_EXHAUSTED	มีคำขอมากเกินไป
NOT_FOUND	ไม่พบทรัพยากร
PERMISSION_DENIED	ผู้ใช้ไม่มีสิทธิ์หรือไม่พบทรัพยากร
INVALID_ARGUMENT	เกิดปัญหากับคำขอ
REQUIRED_FIELD_MISSING	ไม่มีข้อมูลในฟิลด์ที่ต้องระบุ
INVALID_FORMAT	รูปแบบไม่ถูกต้อง
INVALID_HEX_ENCODING	ค่าที่เข้ารหัส HEX มีรูปแบบไม่ถูกต้อง
INVALID_BASE64_ENCODING	ค่าที่เข้ารหัส Base64 มีรูปแบบไม่ถูกต้อง
INVALID_SHA256_FORMAT	ค่าที่เข้ารหัส SHA256 มีรูปแบบไม่ถูกต้อง
INVALID_POSTAL_CODE	รหัสไปรษณีย์ไม่ถูกต้อง
INVALID_COUNTRY_CODE	เลิกใช้งานแล้ว: ไม่ได้ใช้ Enum ใน Data Manager API รายการนี้เลิกใช้งานแล้ว
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	รูปแบบ Mobile 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	รหัสการกระทำที่ถือเป็น Conversion ไม่ถูกต้อง
INVALID_CONVERSION_ACTION_TYPE	ประเภทการกระทำที่ถือเป็น Conversion ไม่ถูกต้อง
INVALID_CURRENCY_CODE	ไม่รองรับรหัสสกุลเงิน
INVALID_EVENT	กิจกรรมนี้ไม่ถูกต้อง
TOO_MANY_EVENTS	จำนวนเหตุการณ์สูงสุดที่อนุญาตต่อคำขอคือ 10,000 รายการ
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	บัญชีปลายทางไม่ได้เปิดใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS	ใช้ Conversion ที่ปรับปรุงแล้วกับบัญชีปลายทางไม่ได้เนื่องจากนโยบายข้อมูลลูกค้าของ Google โปรดติดต่อตัวแทนของ Google
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED	บัญชีปลายทางยังไม่ยอมรับข้อกำหนดสำหรับ Conversion ที่ปรับปรุงแล้ว
DUPLICATE_DESTINATION_REFERENCE	ปลายทางอย่างน้อย 2 แห่งในคำขอมีข้อมูลอ้างอิงเดียวกัน
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER	บัญชีปฏิบัติการที่ไม่รองรับสำหรับการให้สิทธิ์พาร์ทเนอร์ด้านข้อมูล
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER	บัญชีที่ลิงก์ไม่รองรับการให้สิทธิ์พาร์ทเนอร์ด้านข้อมูล
NO_IDENTIFIERS_PROVIDED	ข้อมูลเหตุการณ์ไม่มีตัวระบุผู้ใช้หรือตัวระบุโฆษณา สําหรับการส่งผ่านข้อมูลเหตุการณ์ Floodlight ข้อผิดพลาดนี้บ่งชี้ว่าคําขอไม่มีตัวระบุโฆษณา
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	รหัสคำขอที่ใช้ดึงสถานะของคำขอไม่ถูกต้อง ดึงข้อมูลสถานะได้เฉพาะคำขอที่สำเร็จและไม่มี validate_only=true
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT	เหตุการณ์มีปลายทาง Google Analytics อย่างน้อย 2 รายการ
FIELD_VALUE_TOO_LONG	ค่าของฟิลด์ยาวเกินไป
FIELD_VALUE_TOO_SHORT	ค่าในช่องสั้นเกินไป
TOO_MANY_ELEMENTS	มีองค์ประกอบมากเกินไปในรายการในคำขอ
TOO_FEW_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	รหัสบัญชีลูกค้าไม่ถูกต้อง
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	ระบบไม่รองรับประเภทบัญชีสำหรับการลิงก์พาร์ทเนอร์
MEMBERSHIP_DURATION_TOO_LONG	ระยะเวลาการเป็นสมาชิกในรายชื่อผู้ใช้ยาวเกินไป
INVALID_MERCHANT_ID	ฟิลด์ merchant_id ไม่ถูกต้อง
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED	ลูกค้ามีแคมเปญที่ไม่ได้รับการยกเว้นซึ่งไม่มีการประกาศการโฆษณาด้านการเมืองในสหภาพยุโรป
ACCOUNT_INELIGIBLE_FOR_STORE_SALES	บัญชีไม่มีสิทธิ์ใช้ยอดขายในร้าน
INVALID_MERCHANT_FEED_LANGUAGE_CODE	รหัสภาษาของฟีดผู้ขายไม่ถูกต้อง
INVALID_REGION_CODE	รหัสภูมิภาคไม่ถูกต้อง
INVALID_SUBDIVISION_CODE	รหัสเขตย่อยไม่ถูกต้อง
INVALID_SUBCONTINENT_CODE	รหัสทวีปย่อยไม่ถูกต้อง
INVALID_CONTINENT_CODE	รหัสทวีปไม่ถูกต้อง
INVALID_DEVICE_CATEGORY	หมวดหมู่อุปกรณ์ไม่ถูกต้อง
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED	ตั้งค่าทั้ง app_instance_id และ client_id
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED	พร็อพเพอร์ตี้ Google Analytics เป็นพร็อพเพอร์ตี้ย่อยหรือพร็อพเพอร์ตี้ภาพรวม
THIRD_PARTY_USER_DATA_NOT_ALLOWED	พาร์ทเนอร์ด้านข้อมูลเท่านั้นที่ตั้งค่าข้อมูลผู้ใช้ของบุคคลที่สามได้
INVALID_COUPON_CODE	รหัสคูปองไม่ถูกต้อง
EVENT_SOURCE_AND_DESTINATION_MISMATCH	ประเภทแหล่งที่มาของเหตุการณ์ไม่ตรงกับประเภทปลายทาง
DESTINATION_ACCOUNT_TYPE_MISMATCH	ประเภทบัญชีปลายทางไม่ตรงกับรหัสบัญชีที่ระบุ
CUSTOM_VARIABLE_VALUE_CONTAINS_PII	ค่าของตัวแปรที่กำหนดเองมีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII)
CUSTOM_VARIABLE_NOT_ENABLED	ไม่ได้เปิดใช้ตัวแปรที่กำหนดเอง
INVALID_CUSTOM_VARIABLE_VALUE	ค่าของตัวแปรที่กำหนดเองไม่ถูกต้อง
CUSTOM_VARIABLE_NOT_FOUND	ปลายทางไม่มีตัวแปรที่กำหนดเองที่มีชื่อตรงกับ variable ที่ระบุ
BASELINE_LOCATION_AUTO_DETECTION_FAILED	ตั้งค่าฟิลด์ location_auto_detection_enabled ของคำขอเป็น true แต่การตรวจหาตำแหน่งพื้นฐานอัตโนมัติไม่สำเร็จ
INSIGHTS_MISSING_FOR_DIMENSION	ไม่มีข้อมูลเชิงลึกสำหรับมิติข้อมูลนี้
REQUIRED_PREREQUISITE_LINK_MISSING	ต้องมีลิงก์ข้อกำหนดเบื้องต้นที่จำเป็น (เช่น ลิงก์ Google Ads) เพื่อให้พร็อพเพอร์ตี้ Google Analytics ดำเนินการนี้ได้
INVALID_REMOVE_AS_OF_TIME	เวลาที่นำออกต้องเป็นเวลาในอดีตหรือปัจจุบัน ไม่อนุญาตให้ใช้การประทับเวลาในอนาคตสำหรับการนำสมาชิกในกลุ่มเป้าหมายออก
REQUEST_TOO_OLD	สถานะคำขอจะใช้ได้ประมาณ 50 วันหลังจากที่ API ได้รับคำขอเท่านั้น
CONVERSION_ACTION_TOO_RECENTLY_CREATED	สร้างการกระทำที่ถือเป็น Conversion เร็วเกินไป

กิจกรรม

เหตุการณ์ที่แสดงการโต้ตอบของผู้ใช้กับเว็บไซต์หรือแอปของผู้ลงโฆษณา

ช่อง
destination_references[]	string ไม่บังคับ สตริงอ้างอิงที่ใช้ในการกำหนดปลายทาง หากเว้นว่างไว้ ระบบจะส่งเหตุการณ์ไปยัง destinations ทั้งหมดในคำขอ
transaction_id	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์นี้ ต้องระบุสำหรับเหตุการณ์ที่ส่งเป็นแหล่งข้อมูลเพิ่มเติมสำหรับ Conversion ของแท็ก
event_timestamp	Timestamp ต้องระบุ เวลาที่เกิดเหตุการณ์
last_updated_timestamp	Timestamp ไม่บังคับ ครั้งล่าสุดที่มีการอัปเดตกิจกรรม
user_data	UserData ไม่บังคับ ชิ้นส่วนของข้อมูลที่ได้จากผู้ใช้ ซึ่งแสดงถึงผู้ใช้ที่เชื่อมโยงกับเหตุการณ์
consent	Consent ไม่บังคับ ข้อมูลเกี่ยวกับว่าผู้ใช้ที่เชื่อมโยงได้ให้ความยินยอมประเภทต่างๆ หรือไม่
ad_identifiers	AdIdentifiers ไม่บังคับ ตัวระบุและข้อมูลอื่นๆ ที่ใช้เพื่อจับคู่เหตุการณ์ Conversion กับกิจกรรมออนไลน์อื่นๆ (เช่น การคลิกโฆษณา)
currency	string ไม่บังคับ รหัสสกุลเงินที่เชื่อมโยงกับมูลค่าทางการเงินทั้งหมดภายในเหตุการณ์นี้
event_source	EventSource ไม่บังคับ สัญญาณที่ระบุว่าเหตุการณ์เกิดขึ้นที่ใด (เว็บ แอป ในร้านค้า ฯลฯ)
event_device_info	DeviceInfo ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) เมื่อเกิดเหตุการณ์
cart_data	CartData ไม่บังคับ ข้อมูลเกี่ยวกับธุรกรรมและรายการที่เชื่อมโยงกับกิจกรรม
custom_variables[]	CustomVariable ไม่บังคับ ข้อมูลคู่คีย์/ค่าเพิ่มเติมที่จะส่งไปยังคอนเทนเนอร์ Conversion (การกระทำที่ถือเป็น Conversion หรือกิจกรรม FL)
experimental_fields[]	ExperimentalField ไม่บังคับ รายการคู่คีย์/ค่าสำหรับฟิลด์เวอร์ชันทดลองที่อาจได้รับการเลื่อนขั้นให้เป็นส่วนหนึ่งของ API ในอนาคต
user_properties	UserProperties ไม่บังคับ ข้อมูลที่ผู้ลงโฆษณาประเมินเกี่ยวกับผู้ใช้ ณ เวลาที่เกิดเหตุการณ์
event_name	string ไม่บังคับ ชื่อเหตุการณ์ ต้องระบุสําหรับเหตุการณ์ GA4
client_id	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ผู้ใช้ของไคลเอ็นต์เว็บสำหรับสตรีมเว็บ GA4 นี้
user_id	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด
additional_event_parameters[]	EventParameter ไม่บังคับ กลุ่มพารามิเตอร์เหตุการณ์ที่จะรวมไว้ในเหตุการณ์ที่ยังไม่ได้ระบุโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ
third_party_user_data	UserData ไม่บังคับ ข้อมูลประเภทเดียวกันกับที่ระบุใน user_data แต่มีการแจ้งอย่างชัดเจนว่าข้อมูลดังกล่าวเป็นของบุคคลที่สามและไม่ใช่ข้อมูลผู้ลงโฆษณาบุคคลที่หนึ่ง
event_location	EventLocation ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับตําแหน่งของผู้ใช้เมื่อเกิดเหตุการณ์นี้
app_instance_id	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ผู้ใช้ของไคลเอ็นต์แอปสำหรับสตรีมแอป GA4 นี้
conversion_value	double ไม่บังคับ มูลค่า Conversion ที่เชื่อมโยงกับเหตุการณ์สําหรับ Conversion ตามมูลค่า
conversion_count	double ไม่บังคับ จํานวน Conversion ที่เชื่อมโยงกับเหตุการณ์สําหรับ Conversion ที่อิงตามการนับ

EventLocation

สถานที่ที่เกิดเหตุการณ์

ช่อง
store_id	string ไม่บังคับ ต้องระบุสำหรับยอดขายในร้าน ตัวระบุที่แสดงถึงหน้าร้านจริงที่เกิดเหตุการณ์
city	string ไม่บังคับ ชื่อเมืองที่เกิดเหตุการณ์
subdivision_code	string ไม่บังคับ รหัสเขตย่อย ISO 3166-2 ที่เกิดเหตุการณ์
region_code	string ไม่บังคับ รหัสภูมิภาค CLDR แบบ 2 ตัวอักษรของที่อยู่ผู้ใช้
subcontinent_code	string ไม่บังคับ รหัสอนุทวีปในรูปแบบ UN M49 ที่เกิดเหตุการณ์
continent_code	string ไม่บังคับ รหัสทวีปในรูปแบบ UN M49 ที่เกิดเหตุการณ์

EventParameter

พารามิเตอร์เหตุการณ์สําหรับเหตุการณ์ GA4

ช่อง
parameter_name	string ต้องระบุ ชื่อพารามิเตอร์ที่จะใช้
value	string ต้องระบุ การแสดงสตริงของค่าพารามิเตอร์ที่จะตั้งค่า

EventSource

แหล่งที่มาของเหตุการณ์

Enum
EVENT_SOURCE_UNSPECIFIED	EventSource ที่ไม่ได้ระบุ ไม่ควรใช้
WEB	เหตุการณ์นี้สร้างขึ้นจากเว็บเบราว์เซอร์
APP	กิจกรรมนี้สร้างขึ้นจากแอป
IN_STORE	ระบบสร้างเหตุการณ์จากธุรกรรมในร้านค้า
PHONE	ระบบสร้างกิจกรรมจากการโทร
MESSAGE	ระบบสร้างกิจกรรมจากข้อความ
OTHER	ระบบสร้างกิจกรรมจากแหล่งที่มาอื่นๆ

ExperimentalField

ฟิลด์ทดลองที่แสดงฟิลด์ที่ไม่เป็นทางการ

ช่อง
field	string ไม่บังคับ ชื่อฟิลด์ที่จะใช้
value	string ไม่บังคับ ค่าของช่องที่จะตั้งค่า

FeatureSet

ชุดฟีเจอร์ที่รองรับสำหรับลิงก์พาร์ทเนอร์

Enum
FEATURE_SET_UNSPECIFIED	ชุดฟีเจอร์ที่ไม่ได้ระบุ หากไม่ได้ระบุไว้ ลักษณะการทำงานของระบบจะเป็น FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT โดยค่าเริ่มต้น
FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT	ระบุลิงก์ที่ใช้สําหรับการจัดการกลุ่มเป้าหมายและกิจกรรม
FEATURE_SET_AD_EVENT_MANAGEMENT	ระบุลิงก์ที่ใช้สำหรับการจัดการเหตุการณ์โฆษณา

FieldWarning

คำเตือนระดับแถวอย่างละเอียดพร้อมเส้นทางฟิลด์

ช่อง
reason	WarningReason เหตุผลของคำเตือน
description	string ข้อความเตือนโดยละเอียดที่อธิบายปัญหา
field	string เส้นทางของฟิลด์ที่ทริกเกอร์คำเตือน ใช้รูปแบบเดียวกับ google.rpc.BadRequest.FieldViolation.field

GcpWrappedKeyInfo

ข้อมูลเกี่ยวกับคีย์ที่ห่อไว้ของ Google Cloud Platform

ช่อง
key_type	KeyType ต้องระบุ ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล
wip_provider	string ต้องระบุ ผู้ให้บริการพูล Workload Identity ที่จำเป็นต้องใช้ KEK
kek_uri	string ต้องระบุ รหัสทรัพยากรของ Cloud Key Management Service ใน Google Cloud Platform ควรอยู่ในรูปแบบ 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

ประเภทของอัลกอริทึมที่ใช้ในการเข้ารหัสข้อมูล

Enum
KEY_TYPE_UNSPECIFIED	ประเภทคีย์ที่ไม่ได้ระบุ ไม่ควรใช้
XCHACHA20_POLY1305	อัลกอริทึม XChaCha20-Poly1305

เพศ

ประเภทของเพศตามข้อมูลประชากร (เช่น หญิง)

Enum
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}

GoogleUserIdData

ข้อมูลรหัสผู้ใช้ Google ที่มีรหัสผู้ใช้ Google ที่เข้ารหัส ต้องระบุรหัสผู้ใช้ Google อย่างน้อย 1 รายการ

ช่อง
google_user_ids[]	string ต้องระบุ รายการรหัสผู้ใช้ Google ที่เข้ารหัส

IngestAdEventsRequest

ขออัปโหลดเหตุการณ์โฆษณา

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
ad_events[]	AdEvent ต้องระบุ ต้องระบุ (อย่างน้อย 1 รายการ) รายการเหตุการณ์โฆษณา
encryption_info	EncryptionInfo ไม่บังคับ ข้อมูลเกี่ยวกับคีย์การเข้ารหัสที่ใช้เพื่อเข้ารหัสข้อมูล ต้องระบุฟิลด์นี้เมื่อเหตุการณ์โฆษณามี UserData
validate_only (deprecated)	bool รายการนี้เลิกใช้งานแล้ว ไม่บังคับ หากเป็นจริง ระบบจะตรวจสอบคำขอ แต่จะไม่ดำเนินการ

IngestAdEventsResponse

ประเภทนี้ไม่มีฟิลด์

การตอบกลับจากการดำเนินการส่งผ่านข้อมูลเหตุการณ์โฆษณา

IngestAudienceMembersRequest

ขออัปโหลดสมาชิกในกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestAudienceMembersResponse

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
destinations[]	Destination ต้องระบุ รายการปลายทางที่จะส่งสมาชิกในกลุ่มเป้าหมายไป
audience_members[]	AudienceMember ต้องระบุ รายชื่อผู้ใช้ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร AudienceMember ได้สูงสุด 10000 รายการในคำขอเดียว
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 รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ
field_warnings[]	FieldWarning คำเตือนระดับแถวอย่างละเอียดพร้อมเส้นทางฟิลด์

IngestEventsRequest

ขออัปโหลดสมาชิกในกลุ่มเป้าหมายไปยังปลายทางที่ระบุ แสดงผล IngestEventsResponse

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
destinations[]	Destination ต้องระบุ รายการปลายทางที่จะส่งเหตุการณ์ไป
events[]	Event ต้องระบุ รายการเหตุการณ์ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร Event ได้สูงสุด 2,000 รายการในคำขอเดียว
consent	Consent ไม่บังคับ ความยินยอมระดับคำขอที่จะใช้กับผู้ใช้ทั้งหมดในคำขอ ความยินยอมระดับผู้ใช้จะลบล้างความยินยอมระดับคำขอ และระบุได้ในแต่ละ Event
validate_only	bool ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
encoding	Encoding ไม่บังคับ ต้องระบุสำหรับการอัปโหลด UserData ประเภทการเข้ารหัสของตัวระบุผู้ใช้ สำหรับตัวระบุผู้ใช้ที่แฮช นี่คือประเภทการเข้ารหัสของสตริงที่แฮช สำหรับตัวระบุผู้ใช้ที่แฮชและเข้ารหัส นี่คือประเภทการเข้ารหัสของสตริงที่เข้ารหัสภายนอก แต่ไม่จำเป็นต้องเป็นสตริงที่แฮชภายใน ซึ่งหมายความว่าสตริงที่แฮชภายในอาจเข้ารหัสในลักษณะที่แตกต่างจากสตริงที่เข้ารหัสภายนอก สำหรับUserDataที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจช่องนี้
encryption_info	EncryptionInfo ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลด UserData หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าข้อมูลระบุตัวบุคคลที่อัปโหลดได้รับการแฮชแต่ไม่ได้เข้ารหัส สำหรับUserDataที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจช่องนี้

IngestEventsResponse

คำตอบจาก IngestEventsRequest

ช่อง
request_id	string รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ
field_warnings[]	FieldWarning คำเตือนระดับแถวอย่างละเอียดพร้อมเส้นทางฟิลด์

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 ที่มีประเภทคีย์การอัปโหลดที่เป็นไปได้ของรายชื่อผู้ใช้

Enum
UPLOAD_KEY_TYPE_UNSPECIFIED	ไม่ได้ระบุ
CONTACT_ID	ข้อมูลลูกค้า เช่น อีเมล หมายเลขโทรศัพท์ หรือที่อยู่
MOBILE_ID	รหัสโฆษณาบนอุปกรณ์เคลื่อนที่
USER_ID	รหัสผู้ใช้ที่บุคคลที่สามระบุ
PAIR_ID	รหัสการกระทบยอดข้อมูลระบุตัวตนของผู้เผยแพร่โฆษณา
PSEUDONYMOUS_ID	รหัสแพลตฟอร์มการจัดการข้อมูล รหัสผู้ใช้ Google รหัสที่พาร์ทเนอร์ระบุ รหัสที่ผู้เผยแพร่โฆษณาระบุ IDFA ของ iOS รหัสโฆษณา Android Roku ID รหัส Amazon Fire TV รหัส Xbox หรือ Microsoft รหัสอุปกรณ์ทั่วไป

IpData

ข้อมูลที่อยู่ IP ของผู้ใช้ เราขอแนะนำให้ระบุ observe_start_time และ observe_end_time เพื่อช่วยปรับปรุงอัตราการจับคู่ของการจับคู่ข้อมูลลูกค้า

ช่อง
ip_address	string ต้องระบุ ที่อยู่ IP ที่บันทึกไว้ในขณะที่มีการโต้ตอบกับลูกค้า ยอมรับรูปแบบสตริงมาตรฐานสำหรับทั้ง IPv4 และ IPv6
observe_start_time	Timestamp ไม่บังคับ เวลาของการโต้ตอบแรกที่บันทึกจากที่อยู่ IP นี้ในเซสชัน
observe_end_time	Timestamp ไม่บังคับ เวลาโต้ตอบที่บันทึกล่าสุดจากที่อยู่ IP นี้ในเซสชัน

รายการ

แสดงสินค้าในรถเข็นที่เชื่อมโยงกับเหตุการณ์

ช่อง
merchant_product_id	string ไม่บังคับ รหัสผลิตภัณฑ์ภายในบัญชี Merchant Center
quantity	int64 ไม่บังคับ หมายเลขของสินค้าที่เชื่อมโยงกับเหตุการณ์
unit_price	double ไม่บังคับ ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดธุรกรรมระดับใดๆ
item_id	string ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันเพื่อใช้อ้างอิงรายการ
additional_item_parameters[]	ItemParameter ไม่บังคับ กลุ่มพารามิเตอร์เหตุการณ์ที่เกี่ยวข้องกับสินค้าที่จะรวมไว้ในเหตุการณ์ที่ไม่ได้ระบุไว้แล้วโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ
merchant_id	string ไม่บังคับ รหัส Merchant Center ที่เชื่อมโยงกับสินค้า สําหรับเหตุการณ์ยอดขายในร้าน ค่านี้จะลบล้างค่าที่ตั้งไว้ที่ระดับรถเข็น ระบบจะไม่สนใจฟิลด์นี้สำหรับเหตุการณ์อื่นๆ
merchant_feed_label	string ไม่บังคับ ป้ายกำกับฟีดของฟีด Merchant Center หากยังคงใช้ประเทศอยู่ คุณสามารถใช้รหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 alpha-2 แทนได้ สําหรับเหตุการณ์ยอดขายในร้าน ค่านี้จะลบล้างค่าที่ตั้งไว้ที่ระดับรถเข็น ระบบจะไม่สนใจฟิลด์นี้สำหรับเหตุการณ์อื่นๆ
merchant_feed_language_code	string ไม่บังคับ รหัสภาษาใน ISO 639-1 ที่เชื่อมโยงกับฟีด Merchant Center ที่มีการอัปโหลดสินค้า
custom_variables[]	ItemCustomVariable ไม่บังคับ ข้อมูลคู่คีย์-ค่าเพิ่มเติมที่จะส่งไปยังคอนเทนเนอร์ Conversion (การกระทำที่ถือเป็น Conversion หรือกิจกรรม Floodlight) เมื่อติดตาม Conversion ต่อสินค้า
conversion_value	double ไม่บังคับ มูลค่า Conversion ที่เชื่อมโยงกับสินค้าภายในเหตุการณ์ ในกรณีที่มูลค่า Conversion แตกต่างกันสำหรับสินค้าแต่ละรายการ

ItemCustomVariable

ตัวแปรที่กำหนดเองระดับสินค้าสำหรับ Conversion ของโฆษณา

ช่อง
variable	string ไม่บังคับ ชื่อของตัวแปรที่กำหนดเองที่จะตั้งค่า หากไม่พบตัวแปรสำหรับปลายทางที่ระบุ ระบบจะไม่สนใจตัวแปรนั้น
value	string ไม่บังคับ ค่าที่จะจัดเก็บสำหรับตัวแปรที่กำหนดเอง
destination_references[]	string ไม่บังคับ สตริงอ้างอิงที่ใช้เพื่อกำหนดว่าควรส่งตัวแปรที่กำหนดเองไปยัง Event.destination_references ใด หากเว้นว่าง ระบบจะใช้ Event.destination_references

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) ต้องระบุฟิลด์โดยใช้รูปแบบ Camel Case ทั้งหมดหรือรูปแบบ Snake Case ทั้งหมด อย่าใช้ทั้งการเขียนแบบ Camel Case และ Snake Case การดำเนินการที่รองรับ AND = != > >= < <= ฟังก์ชันที่รองรับ: - IN(field, value1, value2, ...): แสดงผลเป็นจริงหากฟิลด์ตรงกับค่าใดค่าหนึ่ง ตัวอย่าง: IN(user_list_id, 123, 456) ฟิลด์ที่ไม่รองรับ 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} หากต้องการแสดงข้อมูลลูกค้าที่มีใบอนุญาตทั่วโลกทั้งหมดภายใต้บัญชี ให้แทนที่รหัสใบอนุญาตทั่วโลกของรายการผู้ใช้ด้วย "-" (เช่น accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-)
filter	string ไม่บังคับ สตริงตัวกรองที่จะใช้กับคำขอรายการ ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น user_list_id = 123) ต้องระบุฟิลด์โดยใช้รูปแบบ Camel Case ทั้งหมดหรือรูปแบบ Snake Case ทั้งหมด อย่าใช้ทั้งการเขียนแบบ Camel Case และ Snake Case การดำเนินการที่รองรับ AND = != > >= < <= ฟังก์ชันที่รองรับ: - IN(field, value1, value2, ...): แสดงผลเป็นจริงหากฟิลด์ตรงกับค่าใดค่าหนึ่ง ตัวอย่าง: IN(user_list_id, 123, 456) ฟิลด์ที่ไม่รองรับ 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) ต้องระบุฟิลด์โดยใช้รูปแบบ Camel Case ทั้งหมดหรือรูปแบบ Snake Case ทั้งหมด อย่าใช้ทั้งการเขียนแบบ Camel Case และ Snake Case การดำเนินการที่รองรับ AND = != > >= < <= ฟังก์ชันที่รองรับ: - IN(field, value1, value2, ...): แสดงผลเป็นจริงหากฟิลด์ตรงกับค่าใดค่าหนึ่ง ตัวอย่าง: IN(user_list_id, 123, 456) ฟิลด์ที่ไม่รองรับ 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") ต้องระบุฟิลด์โดยใช้รูปแบบ Camel Case ทั้งหมดหรือรูปแบบ Snake Case ทั้งหมด อย่าใช้ทั้งการเขียนแบบ Camel Case และ Snake Case การดำเนินการที่รองรับ AND = != > >= < <= : (มี) ฟังก์ชันที่รองรับ: - IN(field, value1, value2, ...): แสดงผลเป็นจริงหากฟิลด์ตรงกับค่าใดค่าหนึ่ง ตัวอย่าง: IN(display_name, "name1", "name2") ฟิลด์ที่รองรับ 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

ช่วงอัตราการจับคู่ของการอัปโหลดหรือกลุ่มเป้าหมายตามข้อมูลผู้ใช้

Enum
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])

MediaQuartile

ปริมาณของสื่อที่เล่นเป็นควอไทล์แบบไม่ต่อเนื่อง

Enum
MEDIA_QUARTILE_UNSPECIFIED	ควอไทล์สื่อที่ไม่ได้ระบุ
MEDIA_QUARTILE_START	เริ่ม
MEDIA_QUARTILE_FIRST_QUARTILE	ควอร์ไทล์แรก
MEDIA_QUARTILE_MIDPOINT	จุดกึ่งกลาง
MEDIA_QUARTILE_THIRD_QUARTILE	ควอร์ไทล์ที่ 3
MEDIA_QUARTILE_COMPLETE	เสร็จสมบูรณ์

MobileData

รหัสอุปกรณ์เคลื่อนที่สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสอุปกรณ์เคลื่อนที่อย่างน้อย 1 รายการ

ช่อง
mobile_ids[]	string ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา Android, IDFA ของ iOS สำหรับรายชื่อผู้ใช้ที่กำหนดเป้าหมายตามข้อมูลลูกค้า และรหัสโฆษณา Android, IDFA ของ iOS, รหัส Xbox หรือ Microsoft, รหัส Amazon Fire TV, รหัส Roku, รหัสอุปกรณ์ทั่วไปสำหรับรายชื่อผู้ใช้พื้นฐาน) ระบุ mobileIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

MobileIdInfo

ข้อมูลเพิ่มเติมเมื่อ MOBILE_ID เป็นหนึ่งใน upload_key_types

ช่อง
data_source_type	DataSourceType ไม่บังคับ เปลี่ยนแปลงไม่ได้ แหล่งที่มาของข้อมูลการอัปโหลด
key_space	KeySpace ต้องระบุ เปลี่ยนแปลงไม่ได้ คีย์สเปซของรหัสอุปกรณ์เคลื่อนที่
app_id	string ต้องระบุ เปลี่ยนแปลงไม่ได้ สตริงที่ระบุแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ไม่ซ้ำกันซึ่งรวบรวมข้อมูล

KeySpace

พื้นที่คีย์สำหรับรหัสบนอุปกรณ์เคลื่อนที่

Enum
KEY_SPACE_UNSPECIFIED	ไม่ได้ระบุ
IOS	คีย์สเปซ iOS
ANDROID	คีย์สเปซ Android

PairData

รหัส PAIR สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสคู่ (PAIR ID) อย่างน้อย 1 รายการ

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

ช่อง
pair_ids[]	string ต้องระบุ ข้อมูล PII ที่ Clean Room จัดหาให้ ซึ่งแฮชด้วย SHA256 และเข้ารหัสด้วยการเข้ารหัสลับแบบสลับที่ใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายชื่อผู้ใช้ PAIR ระบุ pairIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

PairIdInfo

ข้อมูลเพิ่มเติมเมื่อ PAIR_ID เป็นหนึ่งใน upload_key_types

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

ช่อง
publisher_id	int64 ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุผู้เผยแพร่โฆษณาที่ระบบจะกระทบยอดรายชื่อผู้ใช้ Publisher Advertiser Identity Reconciliation ด้วย ฟิลด์นี้มาจากผู้ให้บริการคลีนรูมและไม่ซ้ำกันเฉพาะในขอบเขตของคลีนรูมนั้น โดยจะใช้เป็นตัวระบุส่วนกลางในคลีนรูมหลายแห่งไม่ได้
publisher_name	string ต้องระบุ ชื่อของผู้เผยแพร่โฆษณาที่มีความหมายซึ่งจะแสดงใน UI เพื่อประสบการณ์การกำหนดเป้าหมายที่ดีขึ้น
match_rate_percentage	int32 ต้องระบุ ฟิลด์นี้ระบุเปอร์เซ็นต์การจับคู่การเป็นสมาชิกของรายชื่อผู้ใช้นี้กับข้อมูลจากบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาที่เกี่ยวข้อง ต้องอยู่ระหว่าง 0 ถึง 100
advertiser_identifier_count	int64 ไม่บังคับ จํานวนระเบียนข้อมูลจากบุคคลที่หนึ่งของผู้ลงโฆษณาที่อัปโหลดไปยังผู้ให้บริการ Clean Room ซึ่งไม่ได้หมายถึงขนาดของรายการผู้ใช้ PAIR
clean_room_identifier	string ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุความสัมพันธ์ที่ไม่ซ้ำกันระหว่างผู้ลงโฆษณากับผู้เผยแพร่โฆษณาที่มีผู้ให้บริการ Clean Room รายเดียวหรือหลายราย

PartnerAudienceInfo

ข้อมูลเพิ่มเติมสำหรับกลุ่มเป้าหมายที่เป็นพาร์ทเนอร์

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

ช่อง
partner_audience_source	PartnerAudienceSource ต้องระบุ เปลี่ยนแปลงไม่ได้ แหล่งที่มาของกลุ่มเป้าหมายพาร์ทเนอร์
commerce_partner	string ไม่บังคับ ชื่อพาร์ทเนอร์ Commerce อนุญาตเฉพาะในกรณีที่ partner_audience_source เป็น COMMERCE_AUDIENCE

PartnerAudienceSource

แหล่งที่มาของกลุ่มเป้าหมายของพาร์ทเนอร์

Enum
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED	ไม่ได้ระบุ
COMMERCE_AUDIENCE	แหล่งที่มาของกลุ่มเป้าหมายพาร์ทเนอร์คือกลุ่มเป้าหมายเชิงพาณิชย์
LINEAR_TV_AUDIENCE	แหล่งที่มาของกลุ่มเป้าหมายพาร์ทเนอร์คือกลุ่มเป้าหมายทีวีแบบดั้งเดิม
AGENCY_PROVIDER_AUDIENCE	แหล่งที่มาของกลุ่มเป้าหมายพาร์ทเนอร์คือกลุ่มเป้าหมายจากเอเจนซี/ผู้ให้บริการ

PartnerCustomerAccount

แสดงบัญชีลูกค้าในระบบของพาร์ทเนอร์

ช่อง
account_id	string ต้องระบุ ตัวระบุบัญชีลูกค้าในพื้นที่รหัสของพาร์ทเนอร์
account_name	string ไม่บังคับ ชื่อบัญชี
account_type	string ไม่บังคับ ประเภทของบัญชี ใช้เพื่อแยกความแตกต่างระหว่างบัญชีผู้ลงโฆษณาและบัญชีระดับธุรกิจได้ เช่น

PartnerLink

ลิงก์พาร์ทเนอร์ระหว่างบัญชีที่เป็นเจ้าของกับบัญชีพาร์ทเนอร์

ช่อง
name	string ตัวระบุ ชื่อของลิงก์พาร์ทเนอร์ รูปแบบ: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
partner_link_id	string เอาต์พุตเท่านั้น รหัสลิงก์พาร์ทเนอร์
owning_account	ProductAccount ต้องระบุ บัญชีที่เป็นเจ้าของซึ่งให้สิทธิ์เข้าถึงบัญชีพาร์ทเนอร์
partner_account	ProductAccount ต้องระบุ บัญชีพาร์ทเนอร์ที่บัญชีที่เป็นเจ้าของให้สิทธิ์เข้าถึง
feature_set	FeatureSet ไม่บังคับ เปลี่ยนแปลงไม่ได้ ชุดฟีเจอร์ที่รองรับสำหรับลิงก์พาร์ทเนอร์ หากไม่ได้ระบุไว้ ลักษณะการทำงานของระบบตามค่าเริ่มต้นจะเป็น FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT
partner_customer_account	PartnerCustomerAccount ไม่บังคับ บัญชีลูกค้าในระบบของพาร์ทเนอร์ ต้องใช้สิทธิ์นี้สำหรับลิงก์พาร์ทเนอร์ที่มีชุดฟีเจอร์ FEATURE_SET_AD_EVENT_MANAGEMENT
partner_link_metadata	PartnerLinkMetadata ไม่บังคับ ข้อมูลเมตาที่เชื่อมโยงกับลิงก์พาร์ทเนอร์ ไม่บังคับและยอมรับเฉพาะลิงก์พาร์ทเนอร์ที่มี FEATURE_SET_AD_EVENT_MANAGEMENT

PartnerLinkMetadata

แสดงข้อมูลเมตาที่เชื่อมโยงกับลิงก์พาร์ทเนอร์

ช่อง
implicit_accounts[]	PartnerCustomerAccount ไม่บังคับ รายการบัญชีโดยนัย

PartnerProvidedIdData

ข้อมูลที่พาร์ทเนอร์ระบุซึ่งมีตัวระบุที่พาร์ทเนอร์ระบุ ต้องระบุตัวระบุที่พาร์ทเนอร์ระบุอย่างน้อย 1 รายการ

ช่อง
partner_provided_ids[]	string ต้องระบุ รายการตัวระบุที่พาร์ทเนอร์ระบุ

แพลตฟอร์ม

รายละเอียดเพิ่มเติมของแพลตฟอร์มที่แสดงโฆษณา

Enum
PLATFORM_UNSPECIFIED	แพลตฟอร์มที่ไม่ได้ระบุ
PLATFORM_IOS	แพลตฟอร์ม iOS
PLATFORM_ANDROID	แพลตฟอร์ม Android
PLATFORM_WEB	แพลตฟอร์มเว็บ

PlatformType

ประเภทของแพลตฟอร์มที่แสดงโฆษณา

Enum
PLATFORM_TYPE_UNSPECIFIED	ประเภทแพลตฟอร์มที่ไม่ได้ระบุ
PLATFORM_TYPE_MOBILE	แพลตฟอร์มอุปกรณ์เคลื่อนที่
PLATFORM_TYPE_DESKTOP	แพลตฟอร์มเดสก์ท็อป
PLATFORM_TYPE_CTV	แพลตฟอร์ม CTV
PLATFORM_TYPE_PHONE	แพลตฟอร์มโทรศัพท์
PLATFORM_TYPE_TABLET	แพลตฟอร์มแท็บเล็ต

PpidData

ข้อมูลตัวระบุที่ผู้เผยแพร่โฆษณามีให้ซึ่งมี PPID ต้องระบุ PPID อย่างน้อย 1 รายการ

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

ช่อง
ppids[]	string ต้องระบุ รายการตัวระบุที่ผู้เผยแพร่โฆษณามีให้สำหรับผู้ใช้

ProcessingErrorReason

สาเหตุของข้อผิดพลาดในการประมวลผล ทั้งนี้ อาจมีการเพิ่มเหตุผลใหม่ๆ ในอนาคต

Enum
PROCESSING_ERROR_REASON_UNSPECIFIED	ไม่ทราบสาเหตุของข้อผิดพลาดในการประมวลผล
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE	ตัวแปรที่กำหนดเองไม่ถูกต้อง
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED	ไม่ได้เปิดใช้สถานะของตัวแปรที่กำหนดเอง
PROCESSING_ERROR_REASON_EVENT_TOO_OLD	Conversion เก่ากว่าอายุสูงสุดที่รองรับ
PROCESSING_ERROR_REASON_DENIED_CONSENT	ผู้ใช้ปฏิเสธการแชร์ข้อมูลผู้ใช้ในโฆษณา หรือมีการตั้งค่าเริ่มต้นของผู้ลงโฆษณา
PROCESSING_ERROR_REASON_NO_CONSENT	ผู้ลงโฆษณาไม่ได้ให้ความยินยอมแก่บุคคลที่สามสำหรับบริการแพลตฟอร์มหลักของโฆษณา
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT	ไม่สามารถระบุความยินยอมโดยรวม (พิจารณาจากความยินยอมระดับแถว ความยินยอมระดับคำขอ และการตั้งค่าบัญชี) สำหรับผู้ใช้รายนี้ได้
PROCESSING_ERROR_REASON_DUPLICATE_GCLID	มี Conversion ที่มี GCLID และเวลาที่เกิด Conversion เดียวกันนี้อยู่ในระบบแล้ว
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID	มีการอัปโหลด Conversion ที่มีชุดค่าผสมรหัสคำสั่งซื้อและการกระทำที่ถือเป็น Conversion เดียวกันแล้ว
PROCESSING_ERROR_REASON_INVALID_GBRAID	ถอดรหัส gbraid ไม่ได้
PROCESSING_ERROR_REASON_INVALID_GCLID	ถอดรหัส Google Click ID ไม่ได้
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID	รหัสผู้ขายมีอักขระที่ไม่ใช่ตัวเลข
PROCESSING_ERROR_REASON_INVALID_WBRAID	ถอดรหัส wbraid ไม่ได้
PROCESSING_ERROR_REASON_INTERNAL_ERROR	ข้อผิดพลาดภายใน
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED	ไม่ได้ลงนามในข้อกำหนดของ Conversion ที่ปรับปรุงแล้วในบัญชีปลายทาง
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 ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น 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	ถอดรหัสข้อมูล UserIdentifier โดยใช้ DEK ไม่สำเร็จ
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER	ผู้ใช้พยายามส่งเหตุการณ์ที่มีตัวระบุโฆษณาซึ่งไม่ได้มาจากโฆษณาของบัญชีปฏิบัติการ
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID	ใช้การกระทําที่ถือเป็น Conversion หนึ่งครั้งต่อคลิกกับ BRAID ไม่ได้
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND	ไม่พบรหัสการแข่งขัน
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID	ไม่พบรหัสผู้ใช้สำหรับรหัสการจับคู่
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID	ไม่พบรหัสผู้ใช้สำหรับ GCLID
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID	ไม่พบรหัสผู้ใช้สำหรับ DCLID
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS	มีตัวระบุโฆษณาที่ไม่ถูกต้อง
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT	รูปแบบรหัสมือถือไม่ถูกต้อง
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND	ไม่พบ Conversion เดิม
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR	ถอดรหัสรหัสเหตุการณ์ (dclid หรือรหัสการแสดงผล) ไม่ได้
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID	ไม่พบรหัสผู้ใช้สําหรับรหัสการแสดงผลที่ระบุ
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND	ไม่พบรหัสผู้ใช้
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK	การประทับเวลาของเหตุการณ์ในเหตุการณ์เกิดขึ้นก่อนการคลิกที่เชื่อมโยง
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK	คลิกเกิดขึ้นเร็วเกินไป
PROCESSING_ERROR_REASON_INVALID_CLICK	ไม่สามารถระบุแหล่งที่มาของเหตุการณ์เป็นคลิก (GCLID) ได้ เนื่องจากการคลิกอาจไม่ได้มาจากแคมเปญ Google Ads เป็นต้น
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK	คลิกจากเหตุการณ์ไม่ได้เชื่อมโยงกับ operating_account ของปลายทาง
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND	ไม่พบคลิกที่เกี่ยวข้องซึ่งตรงกับแอตทริบิวต์ที่ระบุ
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING	ไม่มีข้อมูลการระบุแหล่งที่มาภายนอก ระบบไม่รองรับการส่งเหตุการณ์ไปยังปลายทางสำหรับการกระทำที่ถือเป็น Conversion จากการระบุแหล่งที่มาภายนอก

ProcessingWarningReason

เหตุผลของประกาศเตือนการประมวลผล

Enum
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 ถอดรหัสข้อมูลไม่ได้เนื่องจากเป็น KEK ที่ไม่ถูกต้องหรือไม่พบ
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR	ถอดรหัสข้อมูล UserIdentifier โดยใช้ DEK ไม่สำเร็จ
PROCESSING_WARNING_REASON_INTERNAL_ERROR	ข้อผิดพลาดภายใน
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED	ระบบตรวจสอบสิทธิ์กับ AWS ไม่สำเร็จ

ผลิตภัณฑ์

รายการนี้เลิกใช้งานแล้ว

เลิกใช้งานแล้ว โปรดใช้ AccountType แทน แสดงถึงผลิตภัณฑ์ Google ที่เฉพาะเจาะจง

Enum
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 ต้องระบุ รหัสของบัญชี เช่น รหัสบัญชี Google Ads
account_type	AccountType ต้องระบุ ประเภทของบัญชี เช่น GOOGLE_ADS ต้องระบุ account_type หรือ product ที่เลิกใช้งานแล้ว หากตั้งค่าทั้ง 2 อย่าง ค่าจะต้องตรงกัน

AccountType

แสดงประเภทบัญชี Google ใช้เพื่อค้นหาบัญชีและปลายทาง

Enum
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
FLOODLIGHT_CONFIG	การกำหนดค่า Floodlight
GOOGLE_AD_MANAGER	Google Ad Manager

PseudonymousIdInfo

ข้อมูลเพิ่มเติมเมื่อ PSEUDONYMOUS_ID เป็นหนึ่งใน upload_key_types

ช่อง
sync_status	SyncStatus เอาต์พุตเท่านั้น สถานะการซิงค์ของรายชื่อผู้ใช้
billable_record_count	int64 ไม่บังคับ เปลี่ยนแปลงไม่ได้ จำนวนระเบียนที่เรียกเก็บเงินได้ (เช่น อัปโหลดหรือจับคู่)

SyncStatus

สถานะการซิงค์ของรายชื่อผู้ใช้

Enum
SYNC_STATUS_UNSPECIFIED	ไม่ได้ระบุ
CREATED	ระบบได้สร้างรายการผู้ใช้เป็นตัวยึดตำแหน่งแล้ว ระบบยังคงซิงค์เนื้อหาและ/หรือข้อมูลเมตาของรายการอยู่ รายชื่อผู้ใช้ยังไม่พร้อมใช้งาน
READY_FOR_USE	รายชื่อผู้ใช้พร้อมใช้งานแล้ว เนื้อหาและคุกกี้ได้รับการซิงค์อย่างถูกต้อง
FAILED	เกิดข้อผิดพลาดขณะซิงค์เนื้อหาและ/หรือข้อมูลเมตาของรายการผู้ใช้ ใช้รายชื่อผู้ใช้ไม่ได้

RemoveAllAudienceMembersRequest

คำขอให้นำผู้ใช้ทั้งหมดออกจากกลุ่มเป้าหมายในปลายทางที่ระบุ แสดงผล RemoveAllAudienceMembersResponse

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
destinations[]	Destination ต้องระบุ รายการปลายทางที่จะนำผู้ใช้ออก
remove_as_of_time	Timestamp ไม่บังคับ เวลาที่นำออก หากตั้งค่าไว้ ระบบจะนำเฉพาะสมาชิกในกลุ่มเป้าหมายที่เพิ่มล่าสุดก่อนเวลานี้ออก หากไม่ได้ตั้งค่า ระบบจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น เวลาที่นำออกต้องไม่ใช่เวลาในอนาคต
validate_only	bool ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์

RemoveAllAudienceMembersResponse

คำตอบจาก RemoveAllAudienceMembersRequest

ช่อง
request_id	string รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

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 รหัสที่สร้างขึ้นโดยอัตโนมัติของคำขอ

RequestStatusPerDestination

สถานะคำขอต่อปลายทาง

ช่อง
destination	Destination ปลายทางภายในคำขอ API ของ DM
request_status	RequestStatus สถานะคำขอของปลายทาง
error_info	ErrorInfo ข้อผิดพลาดเกี่ยวกับข้อมูลข้อผิดพลาดที่มีเหตุผลของข้อผิดพลาดและจำนวนข้อผิดพลาดที่เกี่ยวข้องกับการอัปโหลด จะป้อนข้อมูลก็ต่อเมื่อ request_status เป็น FAILED หรือ PARTIAL_SUCCESS ช่องนี้จะไม่มีข้อมูลขณะที่คำขอมีrequest_statusของPROCESSING
warning_info	WarningInfo ข้อมูลคำเตือนที่มีเหตุผลของคำเตือนและจำนวนคำเตือนที่เกี่ยวข้องกับการอัปโหลด ช่องนี้จะไม่มีข้อมูลขณะที่คำขอมีrequest_statusของPROCESSING
ฟิลด์ Union status สถานะของปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
audience_members_ingestion_status	IngestAudienceMembersStatus สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง
events_ingestion_status	IngestEventsStatus สถานะของคำขอเหตุการณ์การส่งผ่านข้อมูล
audience_members_removal_status	RemoveAudienceMembersStatus สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก
remove_all_audience_members_status	RemoveAllAudienceMembersStatus สถานะของคำขอให้นำสมาชิกผู้ชมทั้งหมดออก

DataType

ประเภทของข้อมูล

Enum
DATA_TYPE_UNSPECIFIED	ไม่ได้ระบุประเภทข้อมูล
EMAIL	ข้อมูลดังกล่าวคืออีเมล
PHONE_NUMBER	ข้อมูลเป็นหมายเลขโทรศัพท์
ADDRESS	ข้อมูลเป็นที่อยู่จริง
IP_ADDRESS	ข้อมูลคือที่อยู่ IP

DataTypeCount

จำนวนสำหรับประเภทข้อมูลที่เฉพาะเจาะจง

ช่อง
type	DataType ประเภทของข้อมูล
count	int64 จำนวนสำหรับประเภทข้อมูลนี้

IngestAudienceMembersStatus

สถานะของคำขอสมาชิกในกลุ่มเป้าหมายที่ส่ง

ช่อง
ฟิลด์ Union status สถานะการส่งข้อมูลสมาชิกในกลุ่มเป้าหมายไปยังปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
user_data_ingestion_status	IngestUserDataStatus สถานะการนำเข้าข้อมูลผู้ใช้ไปยังปลายทาง
mobile_data_ingestion_status	IngestMobileDataStatus สถานะการนำเข้าข้อมูลมือถือไปยังปลายทาง
pair_data_ingestion_status	IngestPairDataStatus สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทาง
user_id_data_ingestion_status	IngestUserIdDataStatus สถานะการนำเข้าข้อมูลรหัสผู้ใช้ไปยังปลายทาง
ppid_data_ingestion_status	IngestPpidDataStatus สถานะของการนำเข้าข้อมูล PPID ไปยังปลายทาง
composite_data_ingestion_status	IngestCompositeDataStatus สถานะของการนำเข้าข้อมูลแบบผสมไปยังปลายทาง
google_user_id_data_ingestion_status	IngestGoogleUserIdDataStatus สถานะการนำเข้าข้อมูลรหัสผู้ใช้ Google ไปยังปลายทาง
partner_provided_id_data_ingestion_status	IngestPartnerProvidedIdDataStatus สถานะของการนำเข้าข้อมูลรหัสที่พาร์ทเนอร์ระบุไปยังปลายทาง

IngestCompositeDataStatus

สถานะของการนำเข้าข้อมูลแบบผสมไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
data_type_counts[]	DataTypeCount จำนวนรวมของประเภทข้อมูลที่ส่งในคำขออัปโหลดสำหรับปลายทาง โดยแยกตามประเภทข้อมูล รวมถึงประเภทข้อมูลทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
upload_match_rate_range	MatchRateRange ช่วงอัตราการจับคู่ของการอัปโหลด

IngestEventsStatus

สถานะของการนำเข้าเหตุการณ์ไปยังปลายทาง

ช่อง
record_count	int64 จำนวนเหตุการณ์ทั้งหมดที่ส่งในคำขออัปโหลด รวมเหตุการณ์ทั้งหมดในคำขอ ไม่ว่าระบบจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestGoogleUserIdDataStatus

สถานะของการนำเข้าข้อมูลรหัสผู้ใช้ Google ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
google_user_id_count	int64 จำนวนรหัสผู้ใช้ Google ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสผู้ใช้ Google ทั้งหมดในคำขอ ไม่ว่าระบบจะส่งข้อมูลสำเร็จหรือไม่ก็ตาม

IngestMobileDataStatus

สถานะของการนำเข้าข้อมูลอินเทอร์เน็ตมือถือไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
mobile_id_count	int64 จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestPairDataStatus

สถานะของการนำเข้าข้อมูลคู่ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
pair_id_count	int64 จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestPartnerProvidedIdDataStatus

สถานะของการนำเข้าข้อมูลรหัสที่พาร์ทเนอร์ระบุไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
partner_provided_id_count	int64 จำนวนรหัสทั้งหมดที่พาร์ทเนอร์ระบุซึ่งส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสทั้งหมดที่พาร์ทเนอร์ระบุในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestPpidDataStatus

สถานะของการนำเข้าข้อมูล PPID ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
ppid_count	int64 จำนวน ppids ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวม PPID ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

IngestUserDataStatus

สถานะของการนำเข้าข้อมูลผู้ใช้ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้าข้อมูล

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
user_identifier_count	int64 จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
upload_match_rate_range	MatchRateRange ช่วงอัตราการจับคู่ของการอัปโหลด

IngestUserIdDataStatus

สถานะของการนำเข้าข้อมูลรหัสผู้ใช้ไปยังปลายทางที่มีสถิติที่เกี่ยวข้องกับการนำเข้า

ช่อง
record_count	int64 จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
user_id_count	int64 จำนวนรหัสผู้ใช้ทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมรหัสผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม

RemoveAllAudienceMembersStatus

ประเภทนี้ไม่มีฟิลด์

สถานะของคำขอให้นำสมาชิกผู้ชมทั้งหมดออก

RemoveAudienceMembersStatus

สถานะของคำขอให้นำสมาชิกของกลุ่มเป้าหมายออก

ช่อง
ฟิลด์ Union status สถานะของการนำสมาชิกกลุ่มเป้าหมายออกจากปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
user_data_removal_status	RemoveUserDataStatus สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง
mobile_data_removal_status	RemoveMobileDataStatus สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง
pair_data_removal_status	RemovePairDataStatus สถานะการนำข้อมูลคู่ที่ซิงค์ออกจากปลายทาง
user_id_data_removal_status	RemoveUserIdDataStatus สถานะการนำข้อมูลรหัสผู้ใช้ออกจากปลายทาง
ppid_data_removal_status	RemovePpidDataStatus สถานะการนำข้อมูล PPID ออกจากปลายทาง
composite_data_removal_status	RemoveCompositeDataStatus สถานะการนำข้อมูลแบบผสมออกจากปลายทาง
google_user_id_data_removal_status	RemoveGoogleUserIdDataStatus สถานะการนำข้อมูลรหัสผู้ใช้ Google ออกจากปลายทาง
partner_provided_id_data_removal_status	RemovePartnerProvidedIdDataStatus สถานะของการนำข้อมูลรหัสที่พาร์ทเนอร์ระบุออกจากปลายทาง

RemoveCompositeDataStatus

สถานะการนำข้อมูลแบบผสมออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
data_type_counts[]	DataTypeCount จำนวนรวมของประเภทข้อมูลที่ส่งในคำขอให้นำออก โดยแยกตามประเภทข้อมูล รวมประเภทข้อมูลทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemoveGoogleUserIdDataStatus

สถานะการนำข้อมูลรหัสผู้ใช้ Google ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
google_user_id_count	int64 จำนวนรหัสผู้ใช้ Google ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสผู้ใช้ Google ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemoveMobileDataStatus

สถานะการนำข้อมูลในอุปกรณ์เคลื่อนที่ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
mobile_id_count	int64 จำนวนรหัสอุปกรณ์เคลื่อนที่ทั้งหมดที่ส่งในคำขอลบ รวมรหัสอุปกรณ์เคลื่อนที่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemovePairDataStatus

สถานะการนำข้อมูลคู่ที่ซิงค์ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
pair_id_count	int64 จำนวนรหัสคู่ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสคู่ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemovePartnerProvidedIdDataStatus

สถานะของการนำข้อมูลรหัสที่พาร์ทเนอร์ระบุออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
partner_provided_id_count	int64 จำนวนรหัสที่พาร์ทเนอร์ระบุทั้งหมดที่ส่งในคำขอลบ รวมรหัสทั้งหมดที่พาร์ทเนอร์ระบุในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemovePpidDataStatus

สถานะการนำข้อมูล PPID ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
ppid_count	int64 จำนวน ppids ทั้งหมดที่ส่งในคำขอให้นำออก รวม PPID ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemoveUserDataStatus

สถานะการนำข้อมูลผู้ใช้ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
user_identifier_count	int64 จำนวนตัวระบุผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมตัวระบุผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RemoveUserIdDataStatus

สถานะการนำข้อมูลรหัสผู้ใช้ออกจากปลายทาง

ช่อง
record_count	int64 จำนวนสมาชิกกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
user_id_count	int64 จำนวนรหัสผู้ใช้ทั้งหมดที่ส่งในคำขอให้นำออก รวมรหัสผู้ใช้ทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม

RequestStatus

สถานะคำขอ

Enum
REQUEST_STATUS_UNKNOWN	ไม่ทราบสถานะคำขอ
SUCCESS	การประมวลผลระเบียนทั้งหมดสำเร็จโดยไม่มีข้อผิดพลาด อย่างไรก็ตาม อาจมีคำเตือนในช่อง warning_info
PROCESSING	คำขออยู่ระหว่างการประมวลผล
FAILED	การประมวลผลระเบียนทั้งหมดไม่สำเร็จ ดูรายละเอียดข้อผิดพลาดได้ในช่อง error_info และดูรายละเอียดคำเตือนได้ในช่อง warning_info
PARTIAL_SUCCESS	การประมวลผลเสร็จสมบูรณ์โดยไม่มีข้อผิดพลาดสำหรับบางระเบียน แต่ไม่สำเร็จและมีข้อผิดพลาดสำหรับระเบียนอื่นๆ ดูรายละเอียดข้อผิดพลาดได้ในช่อง error_info และดูรายละเอียดคำเตือนได้ในช่อง warning_info

RetrieveInsightsRequest

ข้อความคำขอสำหรับ DM API MarketingDataInsightsService.RetrieveInsights

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
parent	string ต้องระบุ บัญชีผู้ปกครองที่เป็นเจ้าของกลุ่มเป้าหมายตามรายชื่อผู้ใช้ รูปแบบ: accountTypes/{account_type}/accounts/{account}
baseline	Baseline ต้องระบุ พื้นฐานสำหรับข้อมูลเชิงลึกที่ขอ
user_list_id	string ต้องระบุ รหัสรายชื่อผู้ใช้ที่ขอข้อมูลเชิงลึก

RetrieveInsightsResponse

ข้อความตอบกลับสำหรับ DM API MarketingDataInsightsService.RetrieveInsights

ช่อง
marketing_data_insights[]	MarketingDataInsight มีข้อมูลเชิงลึกสำหรับข้อมูลการตลาด

MarketingDataInsight

ข้อมูลเชิงลึกสำหรับข้อมูลการตลาด

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

ช่อง
dimension	AudienceInsightsDimension มิติข้อมูลที่ข้อมูลเชิงลึกเป็นของ
attributes[]	MarketingDataInsightsAttribute ข้อมูลเชิงลึกสำหรับค่าของมิติข้อมูลที่ระบุ

AudienceInsightsDimension

มิติข้อมูลที่ใช้ได้ในการสร้างข้อมูลเชิงลึก

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED	ไม่ได้ระบุ
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN	ไม่ทราบค่าในเวอร์ชันนี้
AFFINITY_USER_INTEREST	UserInterest ตามกลุ่มความสนใจ
IN_MARKET_USER_INTEREST	UserInterest ที่มีแผนจะซื้อ
AGE_RANGE	ช่วงอายุ
GENDER	เพศ

MarketingDataInsightsAttribute

ข้อมูลเชิงลึกสำหรับชุดแอตทริบิวต์ที่เกี่ยวข้องของมิติข้อมูลเดียวกัน

ช่อง
user_interest_id	int64 รหัสความสนใจของผู้ใช้
lift	float การวัดค่า Lift ที่กลุ่มเป้าหมายมีต่อค่าแอตทริบิวต์เมื่อเทียบกับ Baseline ช่วง [0-1]
age_range	AgeRange ช่วงอายุของกลุ่มเป้าหมายที่มีการวัด Lift
gender	Gender เพศของกลุ่มเป้าหมายที่มีการวัด Lift

RetrieveRequestStatusRequest

คำขอรับสถานะของคำขอที่ส่งไปยัง DM API สำหรับรหัสคำขอที่ระบุ แสดงผล RetrieveRequestStatusResponse

คุณลองใช้วิธีนี้ได้ใน โปรแกรมสำรวจ REST API:

ลองใช้กับ REST

ช่อง
request_id	string ต้องระบุ ต้องระบุ รหัสคำขอของคำขอ Data Manager API

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 จำนวนลิงก์พาร์ทเนอร์สูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลลิงก์พาร์ทเนอร์ไม่เกิน 50 รายการ ค่าสูงสุดคือ 100 และระบบจะบังคับให้ค่าที่สูงกว่า 100 เป็น 100
page_token	string โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ SearchPartnerLinks ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ SearchPartnerLinks ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ
filter	string ไม่บังคับ สตริงตัวกรอง ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น partner_link_id = 123456789) ต้องระบุฟิลด์โดยใช้รูปแบบ Camel Case ทั้งหมดหรือรูปแบบ Snake Case ทั้งหมด อย่าใช้ทั้งการเขียนแบบ Camel Case และ Snake Case การดำเนินการที่รองรับ AND = != ฟิลด์ที่รองรับ partner_link_id owning_account.account_type owning_account.account_id partner_account.account_type partner_account.account_id feature_set สำหรับลิงก์พาร์ทเนอร์ที่มีชุดฟีเจอร์ FEATURE_SET_AD_EVENT_MANAGEMENT ระบบยังรองรับช่องต่อไปนี้ด้วย partner_customer_account.account_id partner_link_metadata.implicit_accounts.account_id ตัวอย่าง: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

SearchPartnerLinksResponse

คำตอบจาก SearchPartnerLinksRequest

ช่อง
partner_links[]	PartnerLink ลิงก์พาร์ทเนอร์สำหรับบัญชีที่ระบุ
next_page_token	string โทเค็นที่ส่งเป็น page_token เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นฟิลด์นี้ จะไม่มีหน้าถัดไป

SizeInfo

จํานวนสมาชิกโดยประมาณในรายการผู้ใช้นี้ในเครือข่ายเป้าหมายต่างๆ

ช่อง
display_network_members_count	int64 เอาต์พุตเท่านั้น จํานวนสมาชิกโดยประมาณในรายชื่อผู้ใช้นี้บนเครือข่าย Display ของ Google
search_network_members_count	int64 เอาต์พุตเท่านั้น จํานวนโดยประมาณของสมาชิกในกลุ่มเป้าหมายตามรายชื่อผู้ใช้ในโดเมน google.com ซึ่งเป็นสมาชิกที่พร้อมให้กำหนดเป้าหมายในแคมเปญ Search
youtube_members_count	int64 เอาต์พุตเท่านั้น จำนวนโดยประมาณของสมาชิกในรายการผู้ใช้นี้บน YouTube
gmail_members_count	int64 เอาต์พุตเท่านั้น จำนวนสมาชิกโดยประมาณในรายชื่อผู้ใช้นี้ใน Gmail

TargetNetworkInfo

ข้อมูลการมีสิทธิ์สำหรับเครือข่ายเป้าหมายต่างๆ

ช่อง
eligible_for_display	bool เอาต์พุตเท่านั้น ระบุว่ารายชื่อผู้ใช้นี้มีสิทธิ์สำหรับเครือข่าย Display ของ Google
eligible_for_search	bool ไม่บังคับ ระบุว่ารายชื่อผู้ใช้นี้มีสิทธิ์สำหรับเครือข่าย Search ของ Google หรือไม่

TargetingType

ประเภทของการกำหนดเป้าหมายที่ใช้ในการแสดงโฆษณา

Enum
TARGETING_TYPE_UNSPECIFIED	ประเภทการกำหนดเป้าหมายที่ไม่ได้ระบุ
TARGETING_TYPE_AUDIENCE	การกำหนดกลุ่มเป้าหมาย
TARGETING_TYPE_CONTEXTUAL	การกำหนดเป้าหมายตามบริบท
TARGETING_TYPE_DEMOGRAPHIC	การกำหนดเป้าหมายตามข้อมูลประชากร
TARGETING_TYPE_DEVICE	การกำหนดอุปกรณ์เป้าหมาย
TARGETING_TYPE_GEO	การกำหนดเป้าหมายตามภูมิศาสตร์
TARGETING_TYPE_INTEREST	การกำหนดเป้าหมายตามความสนใจ
TARGETING_TYPE_PURCHASE_INTENT	การกำหนดเป้าหมายตามความตั้งใจในการซื้อ
TARGETING_TYPE_REMARKETING	การกำหนดเป้าหมายรีมาร์เก็ตติ้ง

TermsOfService

ข้อกำหนดในการให้บริการที่ผู้ใช้ยอมรับ/ปฏิเสธ

ช่อง
customer_match_terms_of_service_status	TermsOfServiceStatus ไม่บังคับ ข้อกำหนดในการให้บริการของการจับคู่ข้อมูลลูกค้า: https://support.google.com/adspolicy/answer/6299717 คุณต้องยอมรับข้อกำหนดนี้เมื่อส่งผ่านข้อมูล UserData หรือ MobileData ช่องนี้ไม่จำเป็นสำหรับรายชื่อผู้ใช้สำหรับการจับคู่พาร์ทเนอร์

TermsOfServiceStatus

แสดงการตัดสินใจของผู้โทรว่าจะยอมรับหรือปฏิเสธข้อกำหนดในการให้บริการ

Enum
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 ไม่บังคับ หากเป็นจริง ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ

UserData

ข้อมูลที่ระบุผู้ใช้ ต้องระบุตัวระบุอย่างน้อย 1 รายการ

ช่อง
user_identifiers[]	UserIdentifier ต้องระบุ ตัวระบุสำหรับผู้ใช้ คุณระบุข้อมูลประเภทเดียวกันได้หลายรายการ (เช่น อีเมลหลายรายการ) ระบุตัวระบุให้มากที่สุดเพื่อเพิ่มโอกาสในการจับคู่ ระบุ userIdentifiers ได้สูงสุด 10 รายการใน AudienceMember หรือ Event เดียว

UserIdData

ข้อมูลรหัสผู้ใช้ที่มีรหัสผู้ใช้

ช่อง
user_id	string ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด

UserIdInfo

ข้อมูลเพิ่มเติมเมื่อ USER_ID เป็นหนึ่งใน upload_key_types

ช่อง
data_source_type	DataSourceType ไม่บังคับ เปลี่ยนแปลงไม่ได้ แหล่งที่มาของข้อมูลการอัปโหลด

UserIdentifier

ตัวระบุเดียวสำหรับผู้ใช้

ช่อง
ฟิลด์ Union identifier ต้องระบุอย่างใดอย่างหนึ่งเท่านั้น identifier ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
email_address	string อีเมลที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากทําการแปลงให้เป็นรูปแบบมาตรฐาน
phone_number	string หมายเลขโทรศัพท์ที่แฮชโดยใช้ฟังก์ชันแฮช SHA-256 หลังจากแปลงเป็นรูปแบบมาตรฐาน (มาตรฐาน E164)
address	AddressInfo องค์ประกอบที่ทราบของที่อยู่ของผู้ใช้ มีกลุ่มตัวระบุที่ตรงกันทั้งหมดในครั้งเดียว

UserList

แหล่งข้อมูลรายชื่อผู้ใช้

ช่อง
name	string ตัวระบุ ชื่อทรัพยากรของกลุ่มเป้าหมายตามรายการผู้ใช้ รูปแบบ: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}
id	int64 เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของรายการผู้ใช้
read_only	bool เอาต์พุตเท่านั้น ตัวเลือกที่ระบุว่าผู้ใช้แก้ไขรายการได้หรือไม่
membership_duration	Duration ไม่บังคับ ระยะเวลาที่ผู้ใช้ยังคงอยู่ในรายชื่อผู้ใช้ ระยะเวลาที่ใช้ได้ต้องเป็นทวีคูณที่แน่นอนของ 24 ชั่วโมง (86400 วินาที) การระบุค่าที่ไม่ใช่ค่าที่คูณด้วย 24 ชั่วโมงจะทำให้เกิดข้อผิดพลาด INVALID_ARGUMENT
access_reason	AccessReason เอาต์พุตเท่านั้น เหตุผลที่บัญชีนี้ได้รับสิทธิ์เข้าถึงรายการ
size_info	SizeInfo เอาต์พุตเท่านั้น จํานวนสมาชิกโดยประมาณในรายการผู้ใช้นี้ในเครือข่ายเป้าหมายต่างๆ
target_network_info	TargetNetworkInfo ไม่บังคับ ข้อมูลการมีสิทธิ์สำหรับเครือข่ายเป้าหมายต่างๆ
display_name	string ต้องระบุ ชื่อที่แสดงของกลุ่มเป้าหมายตามข้อมูลผู้ใช้
description	string ไม่บังคับ คำอธิบายรายการผู้ใช้
membership_status	MembershipStatus ไม่บังคับ สถานะการเป็นสมาชิกของรายชื่อผู้ใช้นี้
integration_code	string ไม่บังคับ รหัสจากระบบภายนอก ผู้ขายรายชื่อผู้ใช้ใช้รหัสนี้เพื่อเชื่อมโยงรหัสในระบบของตน
closing_reason	ClosingReason เอาต์พุตเท่านั้น สาเหตุที่สถานะการเป็นสมาชิกในรายชื่อผู้ใช้นี้ปิดอยู่
account_access_status	AccessStatus ไม่บังคับ ระบุว่าการแชร์นี้ยังเปิดใช้อยู่หรือไม่ เมื่อมีการแชร์รายชื่อผู้ใช้กับบัญชี ระบบจะตั้งค่าช่องนี้เป็น ENABLED ต่อมาเจ้าของรายชื่อผู้ใช้สามารถเลือกที่จะเพิกถอนการแชร์และทำให้เป็นDISABLEDได้
ฟิลด์ Union user_list_info ข้อมูลเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายตามรายการผู้ใช้ user_list_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
ingested_user_list_info	IngestedUserListInfo ไม่บังคับ แสดงรายการผู้ใช้ที่สร้างขึ้นจากข้อมูลผู้ใช้ที่นําเข้า

AccessReason

Enum ที่อธิบายเหตุผลที่เป็นไปได้ในการเข้าถึง

Enum
ACCESS_REASON_UNSPECIFIED	ไม่ได้ระบุ
OWNED	ผู้ใช้เป็นเจ้าของทรัพยากร
SHARED	ระบบจะแชร์ทรัพยากรกับผู้ใช้
LICENSED	ผู้ใช้ได้รับอนุญาตให้ใช้ทรัพยากร
SUBSCRIBED	ผู้ใช้ติดตามทรัพยากร
AFFILIATED	ผู้ใช้เข้าถึงทรัพยากรได้

AccessStatus

ระบุว่าไคลเอ็นต์นี้ยังมีสิทธิ์เข้าถึงรายการอยู่หรือไม่

Enum
ACCESS_STATUS_UNSPECIFIED	ไม่ได้ระบุ
ENABLED	เปิดใช้การเข้าถึงแล้ว
DISABLED	ระบบปิดใช้สิทธิ์เข้าถึงแล้ว

ClosingReason

ระบุสาเหตุที่ปิดรายชื่อผู้ใช้ ระบบจะใช้การแจงนับนี้เฉพาะเมื่อระบบปิดรายการโดยอัตโนมัติ

Enum
CLOSING_REASON_UNSPECIFIED	ไม่ได้ระบุ
UNUSED	ระบบปิดรายการผู้ใช้เนื่องจากไม่ได้ใช้ในการกำหนดเป้าหมายเมื่อเร็วๆ นี้ ดูรายละเอียดได้ที่ https://support.google.com/google-ads/answer/2472738

MembershipStatus

สถานะของกลุ่มเป้าหมายตามรายชื่อผู้ใช้

Enum
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 เปลี่ยนแปลงไม่ได้ รหัสของรายชื่อผู้ใช้ที่ได้รับอนุญาต
client_account_type	UserListLicenseClientAccountType เปลี่ยนแปลงไม่ได้ ประเภทบัญชีของลูกค้าของลูกค้าที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
client_account_id	int64 เปลี่ยนแปลงไม่ได้ รหัสของลูกค้าไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
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 เปลี่ยนแปลงไม่ได้ รหัสของรายชื่อผู้ใช้ที่ได้รับอนุญาต
license_type	UserListGlobalLicenseType เปลี่ยนแปลงไม่ได้ ประเภทสินค้าของลูกค้าของไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
status	UserListLicenseStatus ไม่บังคับ สถานะของ UserListGlobalLicense - ENABLED หรือ DISABLED

UserListGlobalLicenseCustomerInfo

ข้อมูลเกี่ยวกับลูกค้าของใบอนุญาตส่วนกลางของกลุ่มเป้าหมายตามข้อมูลลูกค้า ระบบจะสร้างบัญชีนี้โดยอัตโนมัติเมื่อลูกค้าซื้อใบอนุญาตแบบทั่วโลก

ช่อง
name	string ตัวระบุ ชื่อทรัพยากรของลูกค้าที่มีใบอนุญาตทั่วโลกสำหรับกลุ่มเป้าหมายตามรายชื่อผู้ใช้
user_list_id	int64 เอาต์พุตเท่านั้น รหัสของรายชื่อผู้ใช้ที่ได้รับอนุญาต
user_list_display_name	string เอาต์พุตเท่านั้น ชื่อของกลุ่มเป้าหมายตามรายชื่อผู้ใช้ที่ได้รับอนุญาต
license_type	UserListGlobalLicenseType เอาต์พุตเท่านั้น ประเภทสินค้าของลูกค้าของไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
status	UserListLicenseStatus เอาต์พุตเท่านั้น สถานะของ UserListDirectLicense - ENABLED หรือ DISABLED
pricing	UserListLicensePricing เอาต์พุตเท่านั้น ราคา UserListDirectLicense
client_account_type	UserListLicenseClientAccountType เอาต์พุตเท่านั้น ประเภทสินค้าของลูกค้าของไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
client_account_id	int64 เอาต์พุตเท่านั้น รหัสของลูกค้าไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
client_account_display_name	string เอาต์พุตเท่านั้น ชื่อลูกค้าของไคลเอ็นต์ที่ได้รับอนุญาตให้ใช้รายชื่อผู้ใช้
historical_pricings[]	UserListLicensePricing เอาต์พุตเท่านั้น ประวัติการกำหนดราคาของใบอนุญาตรายชื่อผู้ใช้
metrics	UserListLicenseMetrics เอาต์พุตเท่านั้น เมตริกที่เกี่ยวข้องกับใบอนุญาตนี้ ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อมีการตั้งค่าวันที่เริ่มต้นและวันที่สิ้นสุดในการเรียก ListUserListGlobalLicenseCustomerInfos

UserListGlobalLicenseType

ประเภทใบอนุญาตส่วนกลางของกลุ่มเป้าหมายตามข้อมูลผู้ใช้

Enum
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

ผลิตภัณฑ์ที่เป็นไปได้ของบัญชีลูกค้าสำหรับใบอนุญาตรายชื่อผู้ใช้

Enum
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 เอาต์พุตเท่านั้น รายได้สำหรับใบอนุญาตรายการผู้ใช้ในหน่วยเป็นหนึ่งในล้านของ 1 ดอลลาร์สหรัฐ
start_date	int64 เอาต์พุตเท่านั้น วันที่เริ่มต้น (รวม) ของเมตริกในรูปแบบ ปปปปดดวว เช่น 20260102 หมายถึงวันที่ 2 มกราคม 2026 หากใช้ end_date ในตัวกรอง คุณจะต้องระบุ start_date ด้วย หากไม่ได้รวมทั้ง start_date และ end_date ไว้ในตัวกรอง ระบบจะไม่ป้อนข้อมูลฟิลด์ UserListLicenseMetrics ในการตอบกลับ
end_date	int64 เอาต์พุตเท่านั้น วันที่สิ้นสุด (รวม) ของเมตริกในรูปแบบ ปปปปดดวว เช่น 20260102 หมายถึงวันที่ 2 มกราคม 2026 หากใช้ start_date ในตัวกรอง คุณจะต้องระบุ end_date ด้วย หากไม่ได้รวมทั้ง start_date และ end_date ไว้ในตัวกรอง ระบบจะไม่ป้อนข้อมูลฟิลด์ UserListLicenseMetrics ในการตอบกลับ

UserListLicensePricing

ราคาใบอนุญาตรายการผู้ใช้

ช่อง
pricing_id	int64 เอาต์พุตเท่านั้น รหัสของการกำหนดราคานี้
start_time	Timestamp เอาต์พุตเท่านั้น เวลาเริ่มต้นของการกำหนดราคา
end_time	Timestamp ไม่บังคับ เวลาสิ้นสุดของการกำหนดราคา
pricing_active	bool เอาต์พุตเท่านั้น การกำหนดราคานี้ใช้งานอยู่หรือไม่
buyer_approval_state	UserListPricingBuyerApprovalState เอาต์พุตเท่านั้น สถานะการอนุมัติผู้ซื้อของการกำหนดราคานี้ ช่องนี้เป็นแบบอ่านอย่างเดียว
cost_micros	int64 ไม่บังคับ ต้นทุนที่เชื่อมโยงกับโมเดลในหน่วยไมโคร (10^-6) ในสกุลเงินที่ระบุโดยฟิลด์ currency_code เช่น 2000000 หมายถึง $2 หาก currency_code เป็น USD
currency_code	string ไม่บังคับ สกุลเงินที่ระบุต้นทุนและ max_cost ต้องเป็นรหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217
cost_type	UserListPricingCostType เปลี่ยนแปลงไม่ได้ ประเภทต้นทุนของการกำหนดราคานี้ ตั้งค่าได้เฉพาะในการดำเนินการ create อัปเดตสำหรับใบอนุญาตที่มีอยู่ไม่ได้
max_cost_micros	int64 ไม่บังคับ CPM สูงสุดที่ระบบเรียกเก็บจากกลุ่มเป้าหมายเชิงพาณิชย์ได้เมื่อใช้ประเภทต้นทุน MEDIA_SHARE ค่านี้มีหน่วยเป็นไมโคร (10^-6) และอยู่ในสกุลเงินที่ระบุโดยฟิลด์ currency_code เช่น 2000000 หมายถึง $2 หาก currency_code เป็น USD โดยจะเกี่ยวข้องเฉพาะเมื่อ cost_type คือ MEDIA_SHARE เมื่อ cost_type ไม่ใช่ MEDIA_SHARE และมีการตั้งค่าฟิลด์นี้ ระบบจะแสดงข้อผิดพลาด MAX_COST_NOT_ALLOWED หากไม่ได้ตั้งค่าหรือตั้งค่าเป็น0 จะไม่มีการจำกัด

UserListPricingBuyerApprovalState

สถานะการอนุมัติของผู้ซื้อสำหรับการกำหนดราคาของกลุ่มเป้าหมายตามรายการผู้ใช้

Enum
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED	ไม่ได้ระบุ
PENDING	ไคลเอ็นต์กลุ่มเป้าหมายตามรายการผู้ใช้ยังไม่ได้ยอมรับข้อกำหนดด้านราคาที่เจ้าของกลุ่มเป้าหมายตามรายการผู้ใช้กำหนด
APPROVED	ไคลเอ็นต์รายชื่อผู้ใช้ยอมรับข้อกำหนดด้านราคาที่เจ้าของรายชื่อผู้ใช้กำหนด
REJECTED	ไคลเอ็นต์รายชื่อผู้ใช้ปฏิเสธข้อกำหนดด้านราคาที่เจ้าของรายชื่อผู้ใช้กำหนด

UserListPricingCostType

ประเภทต้นทุนการกำหนดราคาของกลุ่มเป้าหมายตามรายชื่อผู้ใช้

Enum
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED	ไม่ระบุ
CPC	ต้นทุนต่อคลิก
CPM	ต้นทุนต่อการแสดงผลพันครั้ง
MEDIA_SHARE	การแชร์สื่อ

UserListLicenseStatus

สถานะใบอนุญาตของกลุ่มเป้าหมายตามรายชื่อลูกค้า

Enum
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 ต้องระบุ การแสดงสตริงของค่าพร็อพเพอร์ตี้ผู้ใช้ที่จะใช้

ViewType

ประเภทของเหตุการณ์

Enum
VIEW_TYPE_UNSPECIFIED	ประเภทมุมมองที่ไม่ระบุ
VIEW_TYPE_MRC_VIEWED	MRC viewed.
VIEW_TYPE_MRC_RENDERED	MRC แสดงผล

ViewabilityInfo

รายละเอียดการมองเห็นโฆษณาที่แสดง

ช่อง
view_type	ViewType ต้องระบุ ประเภทของเหตุการณ์
viewable_percent	int32 ไม่บังคับ เปอร์เซ็นต์ตัวเลข (0-100) ของพิกเซลที่มองเห็นได้
viewable_duration	Duration ไม่บังคับ ระยะเวลาที่โฆษณามองเห็นได้
media_skippable	bool ไม่บังคับ สื่อโฆษณาข้ามได้หรือไม่
media_quartile	MediaQuartile ไม่บังคับ ปริมาณของสื่อที่เล่นเป็นควอไทล์แบบไม่ต่อเนื่อง
media_duration	Duration ไม่บังคับ ระยะเวลาของสื่อโฆษณา
media_volume_percent	int32 ไม่บังคับ เปอร์เซ็นต์ตัวเลข (0-100) ของระดับเสียงการเล่นสื่อ
playback_duration	Duration ไม่บังคับ ระยะเวลาการเล่นสื่อโฆษณา ไม่ว่าจะมองเห็นได้หรือไม่ก็ตาม

WarningCount

จำนวนประกาศเตือนสำหรับเหตุผลของประกาศเตือนที่ระบุ

ช่อง
record_count	int64 จำนวนระเบียนที่มีคำเตือน
reason	ProcessingWarningReason เหตุผลของคำเตือน

WarningInfo

จำนวนคำเตือนสำหรับคำเตือนแต่ละประเภท

ช่อง
warning_counts[]	WarningCount รายการคำเตือนและจำนวนคำเตือนตามเหตุผลของคำเตือน

WarningReason

เหตุผลของคำเตือนที่ไม่บล็อกซึ่งแสดงขึ้นระหว่างการส่งผ่านข้อมูล

Enum
WARNING_REASON_UNSPECIFIED	เหตุผลของประกาศเตือนที่ไม่ได้ระบุ
WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED	ไม่ได้เปิดใช้ตัวแปรที่กำหนดเองใน custom_variables ในบัญชี
WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED	ค่าตัวแปรที่กำหนดเองใน custom_variables ไม่อยู่ในค่าที่อนุญาตที่กำหนดไว้ล่วงหน้าซึ่งกำหนดค่าสำหรับตัวแปรที่กำหนดเองในบัญชีปลายทาง
WARNING_REASON_CART_DATA_NOT_SUPPORTED_WITH_GBRAID_OR_WBRAID	cart_data ไม่รองรับ gbraid หรือ wbraid
WARNING_REASON_CART_DATA_ITEM_MERCHANT_PRODUCT_ID_MISSING	ไม่มี merchant_product_id ในสินค้าในรถเข็น
WARNING_REASON_CART_DATA_ITEM_UNIT_PRICE_MISSING	ไม่มี unit_price ในสินค้าในรถเข็น
WARNING_REASON_GENERIC	สาเหตุของคำเตือนทั่วไปสำหรับปัญหาที่ไม่ได้อยู่ในหมวดหมู่เฉพาะอื่นๆ
WARNING_REASON_INVALID_CLIENT_ID	client_id ไม่ถูกต้อง
WARNING_REASON_INVALID_SUBDIVISION_CODE	subdivision_code ไม่ถูกต้อง
WARNING_REASON_INVALID_REGION_CODE	region_code ไม่ถูกต้อง
WARNING_REASON_INVALID_SUBCONTINENT_CODE	subcontinent_code ไม่ถูกต้อง
WARNING_REASON_INVALID_CONTINENT_CODE	continent_code ไม่ถูกต้อง
WARNING_REASON_INVALID_DEVICE_CATEGORY	อุปกรณ์ category ไม่ถูกต้อง
WARNING_REASON_INVALID_DEVICE_SCREEN_RESOLUTION	อุปกรณ์ screen_height หรือ screen_width ไม่ถูกต้อง
WARNING_REASON_INVALID_MERCHANT_ID	merchant_id ไม่ถูกต้อง