REST Resource: customers.adsDataLinks

• แหล่งข้อมูล: AdsDataLink
  • การแสดง JSON
• เอนทิตี
  • การแสดง JSON
• ประเภทเอนทิตี
• แพลตฟอร์ม
• เมตริก
• GMPExportScope
• เมธอด

แหล่งข้อมูล: AdsDataLink

แสดงลิงก์ข้อมูลการโฆษณา

การแสดง JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

ช่อง
name	string ชื่อที่ระบุทรัพยากร AdsDataLink แบบไม่ซ้ํา ซึ่งอยู่ในรูปแบบ customer/[customerId]/adsDataLinks/[resource_id] เซิร์ฟเวอร์สร้างรหัสทรัพยากร
linkedEntity	object (Entity) เอนทิตีลิงก์ผ่าน AdsDataLink นี้
parentEntity	object (Entity) เอนทิตีหลักที่เกี่ยวข้อง (หากมี) หากเอนทิตีที่ลิงก์คือแคมเปญ Google Ads ช่องนี้จะมีลูกค้า Google Ads ที่เกี่ยวข้องที่เป็นเจ้าของแคมเปญ
childEntities[]	object (Entity) เอนทิตีย่อยที่เกี่ยวข้อง หากมี หากเอนทิตีที่ลิงก์เป็นลูกค้า Google Ads ที่ตรงกับลิงก์ผู้จัดการลูกค้า ส่วนChildEntities จะรวมลูกค้า Google Ads ทั้งชุดที่มีข้อมูลแบบสมบูรณ์ซึ่งนําเข้าไปยัง Ads Data Hub ผ่านทางลิงก์นี้
platform	enum (Platform) แพลตฟอร์มโฆษณาที่เชื่อมโยงกับเอนทิตีที่ลิงก์ไว้
customerLink	object (CustomerLink) การลิงก์ลูกค้าสําหรับการเข้าถึงข้อมูลที่ลิงก์ ระบบจะป้อนเฉพาะชื่อ รหัสลูกค้า และชื่อที่แสดง
status	enum (LinkStatus) สถานะของลิงก์ข้อมูล
createTime	string (Timestamp format) เวลาที่สร้างลิงก์ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime	string (Timestamp format) เวลาที่อัปเดตสถานะการลิงก์ครั้งล่าสุด การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
vendorClientId	string รหัสไคลเอ็นต์ของผู้ให้บริการ (หากมี)
metrics[]	enum (Metric) เมตริกที่เข้าถึงได้ผ่านทางลิงก์ข้อมูลนี้ หากว่างเปล่า จะไม่มีการใช้ข้อจํากัดเมตริก ปัจจุบันช่องนี้เป็นเพียงเอกพจน์และรองรับเมื่อประเภทลิงก์เป็น GOOGLE_ADS_CAMPAIGN หรือ YT_RESERVE_LINE_ITEM เท่านั้น
gmpExportScopes[]	enum (GmpExportScope) ประเภทของข้อมูลที่จะส่งออกสําหรับลิงก์ Display &AMP และวิดีโอ 360 แสดงเมื่อแพลตฟอร์มคือ GOOGLE_MARKETING_PLATFORM เท่านั้น หากว่างเปล่า ไม่ระบุ และอาจใช้ชุดค่าผสมเหล่านี้ร่วมกันได้

เอนทิตี

แสดงถึงเอนทิตีโฆษณาที่ลิงก์กับลูกค้า Ads Data Hub ได้

การแสดง JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

ช่อง
entityId	string (int64 format) รหัสเอนทิตี ค่าที่แสดงที่นี่ขึ้นอยู่กับประเภทเอนทิตี
displayName	string ชื่อที่แสดงของเอนทิตี
type	enum (EntityType) ประเภทของเอนทิตีที่ลิงก์

ประเภทเอนทิตี

เอนทิตีโฆษณาที่รองรับ

Enum
ENTITY_TYPE_UNSPECIFIED	ประเภทเอนทิตีที่ไม่ระบุ
GOOGLE_ADS_CUSTOMER	ลูกค้า Google Ads entityId สอดคล้องกับ [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] ใน Google Ads API
GOOGLE_ADS_CAMPAIGN	แคมเปญ Google Ads entityId สอดคล้องกับ [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] ใน Google Ads API
GMP_CM_ACCOUNT	บัญชี Campaign Manager ของ Google Marketing Platform entityId สอดคล้องกับ [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts]
GMP_CM_FLOODLIGHT	บัญชี Floodlight ของ Campaign Manager entityId สอดคล้องกับ [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations]
GMP_DV360_PARTNER	รหัสพาร์ทเนอร์ Display &Video 360 entityId คือรหัสพาร์ทเนอร์ DV360
GMP_DV360_ADVERTISER	รหัสผู้ลงโฆษณา Display &Video 360 entityId คือรหัสผู้ลงโฆษณา DV360
GMP_DV360_ORDER	รหัสคําสั่งซื้อ Display &Video 360 entityId คือรหัสคําสั่งซื้อ DV360
GMP_DV360_LINE_ITEM	รหัสรายการโฆษณา Display &Video 360 entityId คือรหัสรายการโฆษณา DV360
YT_RESERVE_ORDER	รหัสคําสั่งซื้อ YouTube Reserve entityId สอดคล้องกับ [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] ใน Google Ads Manager
YT_RESERVE_LINE_ITEM	รายการโฆษณา YouTube Reserve entityId สอดคล้องกับ [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] ใน Google Ads Manager
VENDOR_CLIENT_ID_REGISTRATION	รหัสไคลเอ็นต์ของผู้ให้บริการที่ลงทะเบียนด้วยตนเองโดยผู้ให้บริการเทคโนโลยีโฆษณาบุคคลที่สามเพื่อมอบการวัดผลโดยบุคคลที่สาม
GOOGLE_AD_MANAGER_ORDER	รหัสคําสั่งซื้อของ Google Ad Manager entityId สอดคล้องกับ [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] ใน Google Ads Manager
GOOGLE_AD_MANAGER_LINE_ITEM	รายการโฆษณา Google Ad Manager entityId สอดคล้องกับ [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] ใน Google Ads Manager

แพลตฟอร์ม

แพลตฟอร์มโฆษณาที่รองรับ

Enum
PLATFORM_UNSPECIFIED	แพลตฟอร์มที่ไม่ได้ระบุ
GOOGLE_ADS	เอนทิตีเชื่อมโยงกับ Google Ads
GOOGLE_MARKETING_PLATFORM	เอนทิตีเชื่อมโยงกับ Google Marketing Platform
YOUTUBE_RESERVE	เอนทิตีเชื่อมโยงกับการจองใน YouTube
GOOGLE_AD_MANAGER	เอนทิตีเชื่อมโยงกับ Google Ad Manager
FREEWHEEL	เอนทิตีเชื่อมโยงกับ FreeWheel

เมตริก

เมตริกที่แสดงผ่านลิงก์ข้อมูลโฆษณาได้

Enum
METRIC_UNSPECIFIED	เมตริกที่ไม่ได้ระบุ
BRAND_LIFT	เมตริกที่เกี่ยวข้องกับ Brand Lift
BRAND_SAFETY	เมตริกที่เกี่ยวข้องกับความปลอดภัยของแบรนด์
REACH	เมตริกที่เกี่ยวข้องกับการเข้าถึง ซึ่งลูกค้าคือผู้ลงโฆษณา
VIEWABILITY	เมตริกที่เกี่ยวข้องกับการมองเห็นโฆษณา ซึ่งลูกค้าคือผู้ลงโฆษณา
PUBLISHER_REACH	เมตริกที่เกี่ยวข้องกับการเข้าถึง ซึ่งลูกค้าคือผู้เผยแพร่โฆษณา/ผู้ให้บริการเนื้อหา
PUBLISHER_VIEWABILITY	เมตริกที่เกี่ยวข้องกับการมองเห็นโฆษณา ซึ่งลูกค้าคือผู้เผยแพร่โฆษณา/ผู้ให้บริการเนื้อหา

GMPExportScope

ข้อมูลประเภทต่างๆ ที่ส่งออกสําหรับลิงก์ GMP ได้

Enum
GMP_EXPORT_SCOPE_UNSPECIFIED	ขอบเขตที่ไม่ระบุ
GMP_EXPORT_SCOPE_YT_TRUEVIEW	ควรส่งออกข้อมูล TrueView บน DV360 YouTube
GMP_EXPORT_SCOPE_DT	ควรส่งออกข้อมูล DT

เมธอด
batchApprove	อนุมัติรายการลิงก์ข้อมูลโฆษณาที่รอดําเนินการ
batchReject	ปฏิเสธรายการลิงก์ข้อมูลโฆษณาที่รออนุมัติ
list	แสดงรายการการลิงก์ระหว่างลูกค้าที่ระบุกับเอนทิตีการโฆษณาอื่นๆ ของ Google