Package google.ads.datamanager.v1

ดัชนี

IngestionService

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

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

บริการสำหรับจัดการลิงก์พาร์ทเนอร์

UserListDirectLicenseService

บริการสําหรับจัดการใบอนุญาตโดยตรงของรายชื่อผู้ใช้ การลบไม่ใช่การดำเนินการที่รองรับสำหรับ UserListDirectLicenses ผู้โทรควรอัปเดตสถานะใบอนุญาตเป็น DISABLED เพื่อปิดใช้งานใบอนุญาตแทน

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

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

สร้างใบอนุญาตโดยตรงสำหรับรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

ดึงข้อมูลใบอนุญาตโดยตรงของรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

แสดงรายการใบอนุญาตโดยตรงของรายการผู้ใช้ทั้งหมดที่เป็นของบัญชีหลัก

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

อัปเดตใบอนุญาตโดยตรงของรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

UserListGlobalLicenseService

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

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

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

สร้างใบอนุญาตทั่วโลกสำหรับรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

เรียกใบอนุญาตส่วนกลางของรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

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

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

แสดงใบอนุญาตส่วนกลางของรายการผู้ใช้ทั้งหมดที่บัญชีหลักเป็นเจ้าของ

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

อัปเดตใบอนุญาตส่วนกลางของรายชื่อผู้ใช้

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

UserListService

บริการสำหรับการจัดการทรัพยากร UserList

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

สร้าง UserList

ส่วนหัวการให้สิทธิ์:

เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ

  • login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง login-account รูปแบบ: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

ลบ UserList

ส่วนหัวการให้สิทธิ์:

เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ

  • login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง login-account รูปแบบ: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc GetUserList(GetUserListRequest) returns (UserList)

รับ UserList

ส่วนหัวการให้สิทธิ์:

เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ

  • login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง login-account รูปแบบ: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

แสดง UserList

ส่วนหัวการให้สิทธิ์:

เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ

  • login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง login-account รูปแบบ: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

อัปเดต UserList

ส่วนหัวการให้สิทธิ์:

เมธอดนี้รองรับส่วนหัวที่ไม่บังคับต่อไปนี้เพื่อกำหนดวิธีที่ API อนุญาตการเข้าถึงคำขอ

  • login-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่บัญชี Google ของข้อมูลเข้าสู่ระบบเป็นผู้ใช้ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้บัญชีของคำขอเป็นค่าเริ่มต้น รูปแบบ: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ไม่บังคับ) ชื่อทรัพยากรของบัญชีที่มีลิงก์ผลิตภัณฑ์ที่สร้างไว้แล้วไปยัง login-account รูปแบบ: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

AdIdentifiers

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

ช่อง
session_attributes

string

ไม่บังคับ แอตทริบิวต์เซสชันสําหรับการระบุแหล่งที่มาและการประมาณเหตุการณ์
gclid

string

ไม่บังคับ Google Click ID (gclid) ที่เชื่อมโยงกับเหตุการณ์นี้
gbraid

string

ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์ของแอปและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
wbraid

string

ไม่บังคับ ตัวระบุคลิกสําหรับคลิกที่เชื่อมโยงกับเหตุการณ์บนเว็บและมาจากอุปกรณ์ iOS ตั้งแต่ iOS14
landing_page_device_info

DeviceInfo

ไม่บังคับ ข้อมูลที่รวบรวมเกี่ยวกับอุปกรณ์ที่ใช้ (หากมี) ในขณะที่เข้าสู่เว็บไซต์ของผู้ลงโฆษณาหลังจากโต้ตอบกับโฆษณา

AddressInfo

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

ช่อง
given_name

string

ต้องระบุ ชื่อ (ชื่อแรก) ของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
family_name

string

ต้องระบุ นามสกุลของผู้ใช้เป็นตัวพิมพ์เล็กทั้งหมด ไม่มีเครื่องหมายวรรคตอน ไม่มีช่องว่างนำหน้าหรือต่อท้าย และแฮชเป็น SHA-256
region_code

string

ต้องระบุ รหัสภูมิภาค 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 alpha-2 ของที่อยู่ผู้ใช้
postal_code

string

ต้องระบุ รหัสไปรษณีย์ของที่อยู่ของผู้ใช้

ช่วงอายุ

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

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

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

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

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

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

ไม่บังคับ รายการสินค้าที่เชื่อมโยงกับกิจกรรม

การตั้งค่าความยินยอมตามกฎหมายตลาดดิจิทัล (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

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

CreatePartnerLinkRequest

ขอสร้างทรัพยากร PartnerLink แสดงผล PartnerLink

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

string

ต้องระบุ องค์กรหลักที่เป็นเจ้าของคอลเล็กชันลิงก์พาร์ทเนอร์นี้ รูปแบบ: accountTypes/{account_type}/accounts/{account}

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

DeviceInfo

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

ช่อง
user_agent

string

ไม่บังคับ สตริง User Agent ของอุปกรณ์สำหรับบริบทที่ระบุ
ip_address

string

ไม่บังคับ ที่อยู่ IP ของอุปกรณ์สำหรับบริบทที่ระบุ

หมายเหตุ: Google Ads ไม่รองรับการจับคู่ที่อยู่ IP ของผู้ใช้ปลายทางในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร (UK) หรือสวิตเซอร์แลนด์ (CH) เพิ่มตรรกะเพื่อยกเว้นการแชร์ที่อยู่ IP จากผู้ใช้ในภูมิภาคเหล่านี้แบบมีเงื่อนไข และตรวจสอบว่าคุณได้ให้ข้อมูลที่ชัดเจนและครบถ้วนแก่ผู้ใช้เกี่ยวกับข้อมูลที่คุณรวบรวมในเว็บไซต์ แอป และพร็อพเพอร์ตี้อื่นๆ รวมถึงได้รับความยินยอมในกรณีที่กฎหมายหรือนโยบายที่เกี่ยวข้องของ Google กำหนด ดูรายละเอียดเพิ่มเติมได้ที่หน้าเกี่ยวกับการนำเข้า Conversion ออฟไลน์

การเข้ารหัส

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

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

EncryptionInfo

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

ช่อง
ฟิลด์ Union wrapped_key คีย์ที่ห่อที่ใช้เข้ารหัสข้อมูล wrapped_key ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
gcp_wrapped_key_info

GcpWrappedKeyInfo

ข้อมูลคีย์ที่ปกปิดของ Google Cloud Platform
aws_wrapped_key_info

AwsWrappedKeyInfo

ข้อมูลคีย์ที่ปกปิดของ Amazon Web Services

ErrorCount

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

ช่อง
record_count

int64

จำนวนระเบียนที่อัปโหลดไม่สำเร็จเนื่องจากสาเหตุที่ระบุ
reason

ProcessingErrorReason

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

ErrorInfo

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

ช่อง
error_counts[]

ErrorCount

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

ErrorReason

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

Enum
ERROR_REASON_UNSPECIFIED อย่าใช้ค่าเริ่มต้นนี้
INTERNAL_ERROR เกิดข้อผิดพลาดภายใน
DEADLINE_EXCEEDED คำขอใช้เวลาตอบสนองนานเกินไป
RESOURCE_EXHAUSTED มีคำขอมากเกินไป
NOT_FOUND ไม่พบทรัพยากร
PERMISSION_DENIED ผู้ใช้ไม่มีสิทธิ์หรือไม่พบทรัพยากร
INVALID_ARGUMENT เกิดปัญหากับคำขอ
REQUIRED_FIELD_MISSING ไม่มีข้อมูลในฟิลด์ที่ต้องระบุ
INVALID_FORMAT รูปแบบไม่ถูกต้อง
INVALID_HEX_ENCODING ค่าที่เข้ารหัส HEX มีรูปแบบไม่ถูกต้อง
INVALID_BASE64_ENCODING ค่าที่เข้ารหัส Base64 มีรูปแบบไม่ถูกต้อง
INVALID_SHA256_FORMAT ค่าที่เข้ารหัส SHA256 มีรูปแบบไม่ถูกต้อง
INVALID_POSTAL_CODE รหัสไปรษณีย์ไม่ถูกต้อง
INVALID_COUNTRY_CODE รหัสประเทศไม่ถูกต้อง
INVALID_ENUM_VALUE ใช้ค่า enum ไม่ได้
INVALID_USER_LIST_TYPE ประเภทของรายชื่อผู้ใช้ไม่เกี่ยวข้องกับคำขอนี้
INVALID_AUDIENCE_MEMBER สมาชิกกลุ่มเป้าหมายนี้ไม่ถูกต้อง
TOO_MANY_AUDIENCE_MEMBERS จำนวนสมาชิกกลุ่มเป้าหมายสูงสุดที่อนุญาตต่อคำขอคือ 10,000 ราย
TOO_MANY_USER_IDENTIFIERS จำนวนตัวระบุผู้ใช้สูงสุดที่อนุญาตต่อสมาชิกกลุ่มเป้าหมายคือ 10
TOO_MANY_DESTINATIONS จำนวนปลายทางสูงสุดที่อนุญาตต่อคำขอคือ 10
INVALID_DESTINATION ปลายทางนี้ไม่ถูกต้อง
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED พาร์ทเนอร์ข้อมูลไม่มีสิทธิ์เข้าถึงกลุ่มเป้าหมายตามรายการผู้ใช้ที่เป็นเจ้าของบัญชีปฏิบัติการ
INVALID_MOBILE_ID_FORMAT รูปแบบรหัสมือถือไม่ถูกต้อง
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 ข้อมูลเหตุการณ์ไม่มีตัวระบุผู้ใช้หรือตัวระบุโฆษณา
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 ค่าฟิลด์ยาวเกินไป
TOO_MANY_ELEMENTS มีองค์ประกอบมากเกินไปในรายการในคำขอ
ALREADY_EXISTS มีทรัพยากรดังกล่าวอยู่แล้ว
IMMUTABLE_FIELD_FOR_UPDATE พยายามตั้งค่าฟิลด์ที่แก้ไขไม่ได้สำหรับคำขออัปเดต
INVALID_RESOURCE_NAME ชื่อทรัพยากรไม่ถูกต้อง
INVALID_FILTER ตัวกรองการค้นหาไม่ถูกต้อง
INVALID_UPDATE_MASK มาสก์การอัปเดตไม่ถูกต้อง
INVALID_PAGE_TOKEN โทเค็นหน้าไม่ถูกต้อง
CANNOT_UPDATE_DISABLED_LICENSE อัปเดตใบอนุญาตที่ถูกปิดใช้ไม่ได้
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST ไม่สามารถให้สิทธิ์ในรายการผู้ใช้ที่มีความละเอียดอ่อนแก่ลูกค้ารายนี้
INSUFFICIENT_COST ต้นทุนต่ำเกินไปสำหรับใบอนุญาตนี้
CANNOT_DISABLE_LICENSE ปิดใช้ใบอนุญาตตัวแทนจำหน่ายไม่ได้เนื่องจากมีการใช้งานอยู่
INVALID_CLIENT_ACCOUNT_ID รหัสบัญชีลูกค้าไม่ถูกต้อง
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 ระบบไม่รองรับประเภทบัญชีสำหรับประเภทรายชื่อผู้ใช้

กิจกรรม

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

ช่อง
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

ไม่บังคับ กลุ่มพารามิเตอร์เหตุการณ์ที่จะรวมไว้ในเหตุการณ์ที่ยังไม่ได้ระบุโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ
conversion_value

double

ไม่บังคับ มูลค่า Conversion ที่เชื่อมโยงกับเหตุการณ์สําหรับ Conversion ตามมูลค่า

EventParameter

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

ช่อง
parameter_name

string

ต้องระบุ ชื่อพารามิเตอร์ที่จะใช้
value

string

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

EventSource

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

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

ExperimentalField

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

ช่อง
field

string

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

string

ไม่บังคับ ค่าของช่องที่จะตั้ง

GcpWrappedKeyInfo

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

ช่อง
key_type

KeyType

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

string

ต้องระบุ ผู้ให้บริการพูล 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}

IngestAudienceMembersRequest

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

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

Destination

ต้องระบุ รายการปลายทางที่จะส่งสมาชิกในกลุ่มเป้าหมายไป
audience_members[]

AudienceMember

ต้องระบุ รายชื่อผู้ใช้ที่จะส่งไปยังปลายทางที่ระบุ ส่งทรัพยากร AudienceMember ได้สูงสุด 10,000 รายการในคำขอเดียว
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

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

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

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

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 - รหัส Amazon Fire TV - รหัส Xbox หรือ Microsoft

รายการ

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

ช่อง
merchant_product_id

string

ไม่บังคับ รหัสผลิตภัณฑ์ภายในบัญชี Merchant Center
quantity

int64

ไม่บังคับ หมายเลขของสินค้าที่เชื่อมโยงกับเหตุการณ์
unit_price

double

ไม่บังคับ ราคาต่อหน่วยไม่รวมภาษี ค่าจัดส่ง และส่วนลดธุรกรรมระดับใดๆ
item_id

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันเพื่อใช้อ้างอิงรายการ
additional_item_parameters[]

ItemParameter

ไม่บังคับ กลุ่มพารามิเตอร์เหตุการณ์ที่เกี่ยวข้องกับสินค้าที่จะรวมไว้ในเหตุการณ์ที่ไม่ได้ระบุไว้แล้วโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ

ItemParameter

กลุ่มพารามิเตอร์เหตุการณ์ที่เกี่ยวข้องกับสินค้าที่จะรวมไว้ในเหตุการณ์ที่ไม่ได้ระบุไว้แล้วโดยใช้ฟิลด์ที่มีโครงสร้างอื่นๆ

ช่อง
parameter_name

string

ต้องระบุ ชื่อพารามิเตอร์ที่จะใช้
value

string

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

ListUserListDirectLicensesRequest

คำขอแสดงรายการทรัพยากร UserListDirectLicense ทั้งหมดสำหรับบัญชีที่ระบุ

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

string

ต้องระบุ บัญชีที่มีการค้นหาใบอนุญาต ควรอยู่ในรูปแบบ accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

ไม่บังคับ ตัวกรองที่จะใช้กับคำขอรายการ ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น user_list_id = 123)

การดำเนินการที่รองรับ

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

ฟิลด์ที่ไม่รองรับ

  • name (ใช้เมธอด get แทน)
  • historical_pricings และสาขาย่อยทั้งหมด
  • pricing.start_time
  • pricing.end_time
page_size

int32

ไม่บังคับ จำนวนใบอนุญาตสูงสุดที่จะแสดงต่อหน้า บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลใบอนุญาตสูงสุด 50 รายการ ค่าสูงสุดคือ 1,000 และค่าที่มากกว่า 1,000 จะถูกบังคับให้เป็น 1,000
page_token

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ ListUserListDirectLicense ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ ListUserListDirectLicense ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ

ListUserListDirectLicensesResponse

คำตอบจาก ListUserListDirectLicensesRequest

ช่อง
user_list_direct_licenses[]

UserListDirectLicense

ใบอนุญาตสำหรับรายชื่อผู้ใช้ที่ระบุในคำขอ
next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

ListUserListGlobalLicenseCustomerInfosRequest

ขอแสดงรายการทรัพยากร UserListGlobalLicenseCustomerInfo ทั้งหมดสำหรับผู้ใช้ที่ระบุซึ่งมีใบอนุญาตส่วนกลาง

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

string

ต้องระบุ ใบอนุญาตส่วนกลางที่มีการค้นหาข้อมูลลูกค้า ควรอยู่ในรูปแบบ accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} หากต้องการแสดงข้อมูลลูกค้าที่มีใบอนุญาตทั่วโลกทั้งหมดภายใต้บัญชี ให้แทนที่รหัสใบอนุญาตทั่วโลกของรายชื่อผู้ใช้ด้วย "-" (เช่น accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-)
filter

string

ไม่บังคับ ตัวกรองที่จะใช้กับคำขอรายการ ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น user_list_id = 123)

การดำเนินการที่รองรับ

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

ฟิลด์ที่ไม่รองรับ

  • name (ใช้เมธอด get แทน)
  • historical_pricings และสาขาย่อยทั้งหมด
  • pricing.start_time
  • pricing.end_time
page_size

int32

ไม่บังคับ จำนวนใบอนุญาตสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลใบอนุญาตสูงสุด 50 รายการ ค่าสูงสุดคือ 1,000 และค่าที่มากกว่า 1,000 จะถูกบังคับให้เป็น 1,000
page_token

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ ListUserListDirectLicense ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ ListUserListDirectLicense ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ

ListUserListGlobalLicenseCustomerInfosResponse

การตอบกลับจาก [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest]

ช่อง
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

ข้อมูลลูกค้าสำหรับใบอนุญาตที่ระบุในคำขอ
next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

ListUserListGlobalLicensesRequest

คำขอแสดงรายการทรัพยากร UserListGlobalLicense ทั้งหมดสำหรับบัญชีที่ระบุ

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

string

ต้องระบุ บัญชีที่มีการค้นหาใบอนุญาต ควรอยู่ในรูปแบบ accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}
filter

string

ไม่บังคับ ตัวกรองที่จะใช้กับคำขอรายการ ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น user_list_id = 123)

การดำเนินการที่รองรับ

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

ฟิลด์ที่ไม่รองรับ

  • name (ใช้เมธอด get แทน)
  • historical_pricings และสาขาย่อยทั้งหมด
  • pricing.start_time
  • pricing.end_time
page_size

int32

ไม่บังคับ จำนวนใบอนุญาตสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลใบอนุญาตสูงสุด 50 รายการ ค่าสูงสุดคือ 1,000 และค่าที่มากกว่า 1,000 จะถูกบังคับให้เป็น 1,000
page_token

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ ListUserListGlobalLicense ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ ListUserListDirectLicense ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ

ListUserListGlobalLicensesResponse

คำตอบจาก ListUserListGlobalLicensesRequest

ช่อง
user_list_global_licenses[]

UserListGlobalLicense

ใบอนุญาตสำหรับรายชื่อผู้ใช้ที่ระบุในคำขอ
next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

ListUserListsRequest

ข้อความคำขอสำหรับ ListUserLists

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

string

ต้องระบุ บัญชีหลักที่เป็นเจ้าของกลุ่มรายการผู้ใช้นี้ รูปแบบ: accountTypes/{account_type}/accounts/{account}
page_size

int32

ไม่บังคับ จำนวนรายการผู้ใช้สูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงรายการผู้ใช้สูงสุด 50 รายการ ค่าสูงสุดคือ 1,000 และค่าที่มากกว่า 1,000 จะถูกบังคับให้เป็น 1,000
page_token

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ ListUserLists ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ ListUserLists ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
filter

string

ไม่บังคับ สตริงตัวกรอง ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น display_name = "list 1")

การดำเนินการที่รองรับ

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (มี)

ฟิลด์ที่รองรับ

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

ข้อความตอบกลับสำหรับ ListUserLists

ช่อง
user_lists[]

UserList

รายการผู้ใช้จากบัญชีที่ระบุ
next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

MatchRateRange

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

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

MobileData

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

ช่อง
mobile_ids[]

string

ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา/IDFA) ระบุ 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 อย่างน้อย 1 รายการ

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

ช่อง
pair_ids[]

string

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

PairIdInfo

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

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

ช่อง
match_rate_percentage

int32

เอาต์พุตเท่านั้น ฟิลด์นี้ระบุเปอร์เซ็นต์การจับคู่การเป็นสมาชิกของรายชื่อผู้ใช้นี้กับข้อมูลจากบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาที่เกี่ยวข้อง ต้องอยู่ระหว่าง 0 ถึง 100
advertiser_identifier_count

int64

เอาต์พุตเท่านั้น จํานวนระเบียนข้อมูลจากบุคคลที่หนึ่งของผู้ลงโฆษณาที่อัปโหลดไปยังผู้ให้บริการ Clean Room ซึ่งไม่ได้หมายถึงขนาดของกลุ่มเป้าหมายตามข้อมูลลูกค้า
publisher_id

int64

ต้องระบุ เปลี่ยนแปลงไม่ได้ ระบุผู้เผยแพร่โฆษณาที่ระบบจะกระทบรหัสผู้ใช้ในรายการกลุ่มเป้าหมาย Publisher Advertiser Identity Reconciliation ฟิลด์นี้มาจากผู้ให้บริการคลีนรูมและไม่ซ้ำกันเฉพาะในขอบเขตของคลีนรูมนั้น โดยจะใช้เป็นตัวระบุส่วนกลางในคลีนรูมหลายแห่งไม่ได้
publisher_name

string

ไม่บังคับ ชื่อของผู้เผยแพร่โฆษณาที่มีความหมายซึ่งจะแสดงใน UI เพื่อประสบการณ์การกำหนดเป้าหมายที่ดีขึ้น
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 แหล่งที่มาของกลุ่มเป้าหมายพาร์ทเนอร์คือกลุ่มเป้าหมายจากเอเจนซี/ผู้ให้บริการ

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_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 ผู้ใช้พยายามส่งเหตุการณ์ที่มีตัวระบุโฆษณาซึ่งไม่ได้มาจากโฆษณาของบัญชีปฏิบัติการ

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

PseudonymousIdInfo

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

ช่อง
sync_status

SyncStatus

เอาต์พุตเท่านั้น สถานะการซิงค์ของรายชื่อผู้ใช้
billable_record_count

int64

ไม่บังคับ เปลี่ยนแปลงไม่ได้ จำนวนระเบียนที่เรียกเก็บเงินได้ (เช่น อัปโหลดหรือจับคู่)

SyncStatus

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

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

RemoveAudienceMembersRequest

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

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

Destination

ต้องระบุ รายการปลายทางที่จะนำผู้ใช้ออก
audience_members[]

AudienceMember

ต้องระบุ รายชื่อผู้ใช้ที่จะนำออก
validate_only

bool

ไม่บังคับ เพื่อวัตถุประสงค์ในการทดสอบ หากเป็น true ระบบจะตรวจสอบคำขอแต่จะไม่ดำเนินการ ระบบจะแสดงเฉพาะข้อผิดพลาด ไม่ใช่ผลลัพธ์
encoding

Encoding

ไม่บังคับ ต้องระบุสำหรับการอัปโหลด UserData ประเภทการเข้ารหัสของตัวระบุผู้ใช้ ใช้กับการเข้ารหัสภายนอกสำหรับตัวระบุผู้ใช้ที่เข้ารหัสเท่านั้น สำหรับUserDataที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้
encryption_info

EncryptionInfo

ไม่บังคับ ข้อมูลการเข้ารหัสสำหรับการอัปโหลด UserData หากไม่ได้ตั้งค่าไว้ ระบบจะถือว่าข้อมูลระบุตัวตนที่อัปโหลดได้รับการแฮชแต่ไม่ได้เข้ารหัส สำหรับUserDataที่ไม่ใช่การอัปโหลด ระบบจะไม่สนใจฟิลด์นี้

RemoveAudienceMembersResponse

คำตอบจาก RemoveAudienceMembersRequest

ช่อง
request_id

string

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

RequestStatusPerDestination

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

ช่อง
destination

Destination

ปลายทางภายในคำขอ DM API
request_status

RequestStatus

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

ErrorInfo

ข้อผิดพลาดเกี่ยวกับข้อมูลข้อผิดพลาดที่มีเหตุผลของข้อผิดพลาดและจำนวนข้อผิดพลาดที่เกี่ยวข้องกับการอัปโหลด
warning_info

WarningInfo

ข้อมูลคำเตือนที่มีเหตุผลของคำเตือนและจำนวนคำเตือนที่เกี่ยวข้องกับการอัปโหลด
ฟิลด์ Union status สถานะของปลายทาง status ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
audience_members_ingestion_status

IngestAudienceMembersStatus

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

IngestEventsStatus

สถานะของคำขอเหตุการณ์การส่งผ่านข้อมูล
audience_members_removal_status

RemoveAudienceMembersStatus

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

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 ไปยังปลายทาง

IngestEventsStatus

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

ช่อง
record_count

int64

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

IngestMobileDataStatus

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

ช่อง
record_count

int64

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

int64

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

IngestPairDataStatus

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

ช่อง
record_count

int64

จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขออัปโหลดสำหรับปลายทาง รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำเข้าสำเร็จหรือไม่ก็ตาม
pair_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

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

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 ออกจากปลายทาง

RemoveMobileDataStatus

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

ช่อง
record_count

int64

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

int64

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

RemovePairDataStatus

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

ช่อง
record_count

int64

จำนวนสมาชิกในกลุ่มเป้าหมายทั้งหมดที่ส่งในคำขอให้นำออก รวมสมาชิกกลุ่มเป้าหมายทั้งหมดในคำขอ ไม่ว่าจะนำออกสำเร็จหรือไม่ก็ตาม
pair_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 คำขอสำเร็จ
PROCESSING คำขออยู่ระหว่างดำเนินการ
FAILED คำขอล้มเหลว
PARTIAL_SUCCESS คำขอสำเร็จบางส่วน

RetrieveInsightsRequest

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

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

string

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

Baseline

ต้องระบุ ค่าพื้นฐานสำหรับข้อมูลเชิงลึกที่ขอ
user_list_id

string

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

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 ความสนใจของผู้ใช้ตามกลุ่มความสนใจ
IN_MARKET_USER_INTEREST ความสนใจของผู้ใช้ที่มีแผนจะซื้อ
AGE_RANGE ช่วงอายุ
GENDER เพศ

MarketingDataInsightsAttribute

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

ช่อง
user_interest_id

int64

รหัสความสนใจของผู้ใช้
lift

float

การวัดการเพิ่มที่กลุ่มเป้าหมายมีต่อค่าแอตทริบิวต์เมื่อเทียบกับค่าพื้นฐาน ช่วง [0-1]
age_range

AgeRange

ช่วงอายุของกลุ่มเป้าหมายที่มีการวัดการเพิ่ม
gender

Gender

เพศของกลุ่มเป้าหมายที่มีการวัดการเพิ่ม

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

จำนวนลิงก์พาร์ทเนอร์สูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลลิงก์พาร์ทเนอร์อย่างน้อย 10 รายการ ค่าสูงสุดคือ 100 และค่าที่สูงกว่า 100 จะถูกบังคับให้เป็น 100
page_token

string

โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ SearchPartnerLinks ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ SearchPartnerLinks ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
filter

string

ไม่บังคับ สตริงตัวกรอง ฟิลด์ทั้งหมดต้องอยู่ทางด้านซ้ายของแต่ละเงื่อนไข (เช่น partner_link_id = 123456789)

การดำเนินการที่รองรับ

  • AND
  • =
  • !=

ฟิลด์ที่รองรับ

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

ตัวอย่าง: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

คำตอบจาก SearchPartnerLinksRequest

ช่อง
next_page_token

string

โทเค็นที่ส่งเป็น page_token เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

SizeInfo

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

ช่อง
display_network_members_count

int64

เอาต์พุตเท่านั้น จํานวนสมาชิกโดยประมาณในรายชื่อผู้ใช้นี้บนเครือข่าย Display ของ Google
search_network_members_count

int64

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

TargetNetworkInfo

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

ช่อง
eligible_for_display

bool

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

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 - เปิดใช้หรือปิดใช้

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 - เปิดใช้หรือปิดใช้
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

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

ต้องระบุ การแสดงสตริงของค่าพร็อพเพอร์ตี้ผู้ใช้ที่จะใช้

WarningCount

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

ช่อง
record_count

int64

จำนวนระเบียนที่มีคำเตือน
reason

ProcessingWarningReason

เหตุผลของคำเตือน

WarningInfo

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

ช่อง
warning_counts[]

WarningCount

รายการคำเตือนและจำนวนคำเตือนตามสาเหตุของคำเตือน