Ads Data Hub API

API สําหรับดําเนินการคําค้นหา Ads Data Hub

บริการ: adsdatahub.googleapis.com

หากต้องการเรียกใช้บริการนี้ เราขอแนะนําให้ใช้ไลบรารีของไคลเอ็นต์ที่ Google ให้ไว้ หากแอปพลิเคชันต้องใช้ไลบรารีของคุณเองเพื่อเรียกใช้บริการนี้ ให้ใช้ข้อมูลต่อไปนี้เมื่อคุณส่งคําขอ API

เอกสารการค้นพบ

เอกสาร Discovery เป็นข้อมูลจําเพาะที่เครื่องอ่านได้สําหรับการอธิบายและใช้ REST API ซึ่งจะใช้ในการสร้างไลบรารีของไคลเอ็นต์ ปลั๊กอิน IDE และเครื่องมืออื่นๆ ที่โต้ตอบกับ Google API บริการหนึ่งอาจให้เอกสารการค้นพบหลายรายการ บริการนี้มีเอกสารการค้นพบต่อไปนี้

ปลายทางบริการ

ปลายทางบริการคือ URL พื้นฐานที่ระบุที่อยู่เครือข่ายของบริการ API บริการหนึ่งอาจมีปลายทางบริการหลายรายการ บริการนี้มีปลายทางบริการดังต่อไปนี้ และ URI ทั้งหมดด้านล่างเกี่ยวข้องกับปลายทางของบริการนี้

  • https://adsdatahub.googleapis.com

ทรัพยากร REST: v1.customers

เมธอด
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
อธิบายถึงรหัสผู้ลงโฆษณา DV360 ที่ถูกต้อง
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
แสดงตัวจับคู่เหตุการณ์ที่ถูกต้องพร้อมกับข้อมูลเมตาสําหรับรายการกลุ่มเป้าหมายในการกําหนดความถี่สูงสุด
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
ส่งออกประวัติงานของบัญชีลูกค้าไปยังชุดข้อมูล BigQuery ที่ลูกค้าเลือก
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
เริ่มการดําเนินการค้นหาเพื่อเรียกข้อมูลเมตริกการมองเห็นโฆษณาที่ไม่ถูกต้องสําหรับแพลตฟอร์ม DV360
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
เริ่มดําเนินการค้นหาเพื่อดึงข้อมูลสรุปยอดการเข้าชมที่ไม่ถูกต้องสําหรับแพลตฟอร์มนั้นๆ ในแต่ละวัน
get GET /v1/{name=customers/*}
เรียกข้อมูลลูกค้า Ads Data Hub ที่ขอ
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
แสดงผลเปอร์เซ็นต์ของข้อมูล Google สําหรับลูกค้าทั้งหมดที่นําเข้าไปยัง ADH เรียบร้อยแล้วในวันที่ระบุ
list GET /v1/customers
แสดงรายชื่อลูกค้า Ads Data Hub ที่ผู้ใช้ปัจจุบันมีสิทธิ์เข้าถึง

ทรัพยากร REST: v1.customers.adsDataCustomers

เมธอด
get GET /v1/{name=customers/*/adsDataCustomers/*}
เรียกข้อมูลลูกค้า Ads Data Hub ที่ขอ
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
ดึงงบประมาณการเข้าถึงข้อมูลสําหรับแหล่งข้อมูลโฆษณาที่ขอในช่วง 366 วันที่ผ่านมา
list GET /v1/{parent=customers/*}/adsDataCustomers
แสดงรายการข้อมูลโฆษณาที่ลูกค้าเข้าถึงได้

ทรัพยากร REST: v1.customers.analysisQuery

เมธอด
create POST /v1/{parent=customers/*}/analysisQueries
สร้างการค้นหาการวิเคราะห์สําหรับการดําเนินการในภายหลัง
delete DELETE /v1/{name=customers/*/analysisQueries/*}
ลบการค้นหาการวิเคราะห์
get GET /v1/{name=customers/*/analysisQueries/*}
ดึงการค้นหาการวิเคราะห์ที่ขอ
list GET /v1/{parent=customers/*}/analysisQueries
จะแสดงรายการสืบค้นการวิเคราะห์ที่เป็นของลูกค้าที่ระบุ
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
อัปเดตการค้นหาการวิเคราะห์ที่มีอยู่
start POST /v1/{name=customers/*/analysisQueries/*}:start
เริ่มการดําเนินการในการค้นหาการวิเคราะห์ที่จัดเก็บไว้
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
เริ่มดําเนินการกับคําค้นหาการวิเคราะห์แบบชั่วคราว
validate POST /v1/{parent=customers/*}/analysisQueries:validate
ทําการตรวจสอบความถูกต้องคงที่ในคําค้นหาการวิเคราะห์ที่ให้มา

ทรัพยากร REST: v1.customers.customBiddingAlgorithms

เมธอด
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
เพิ่มผู้ลงโฆษณา DV360 ลงในอัลกอริทึมการเสนอราคาที่กําหนดเอง ##99
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
สร้างอัลกอริทึมการเสนอราคาที่กําหนดเองที่จัดการโดย Ads Data Hub
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
ลบอัลกอริทึมการเสนอราคาที่กําหนดเองนี้
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
สะสมคะแนนในช่วง 30 วันล่าสุดของการแสดงผลสําหรับรูปแบบการเสนอราคาที่กําหนดเอง
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
เรียกข้อมูลอัลกอริทึมการเสนอราคาที่กําหนดเองที่จัดการโดย Ads Data Hub ที่ขอ
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
แสดงอัลกอริทึมการเสนอราคาที่กําหนดเองที่จัดการโดยลูกค้า Ads Data Hub ที่ระบุ
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
อัปเดตอัลกอริทึมการเสนอราคาที่กําหนดเองที่จัดการโดย Ads Data Hub ที่ขอ
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
นําผู้ลงโฆษณา DV360 ออกจากอัลกอริทึมการเสนอราคาที่กําหนดเอง ##99

ทรัพยากร REST: v1.customers.tables

เมธอด
get GET /v1/{name=customers/*/tables/*}
เรียกข้อมูลตาราง Ads Data Hub ที่ขอ
list GET /v1/{parent=customers/*}/tables
แสดงตาราง Ads Data Hub ที่ลูกค้าที่ระบุมีสิทธิ์เข้าถึง

ทรัพยากร REST: v1.customers.tempTables

เมธอด
get GET /v1/{name=customers/*/tempTables/*}
ดึงตารางอุณหภูมิของ Ads Data Hub ที่ขอ
list GET /v1/{parent=customers/*}/tempTables
แสดงตารางชั่วคราวของ Ads Data Hub ที่ลูกค้าสร้าง

ทรัพยากร REST: v1.customers.userListQuery

เมธอด
create POST /v1/{parent=customers/*}/userListQueries
สร้างการค้นหารายชื่อผู้ใช้สําหรับการดําเนินการในภายหลัง
delete DELETE /v1/{name=customers/*/userListQueries/*}
ลบการค้นหารายชื่อผู้ใช้
get GET /v1/{name=customers/*/userListQueries/*}
เรียกข้อมูลคําค้นหาในรายชื่อผู้ใช้ที่ขอ
list GET /v1/{parent=customers/*}/userListQueries
แสดงการค้นหารายการผู้ใช้ที่เป็นของลูกค้าที่ระบุ
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
อัปเดตการค้นหารายการผู้ใช้ที่มีอยู่
start POST /v1/{name=customers/*/userListQueries/*}:start
เริ่มการดําเนินการในการค้นหารายการผู้ใช้ที่จัดเก็บไว้
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
เริ่มดําเนินการกับคําค้นหารายชื่อผู้ใช้ชั่วคราว
validate POST /v1/{parent=customers/*}/userListQueries:validate
ทําการตรวจสอบความถูกต้องแบบคงที่ในการค้นหารายการผู้ใช้ที่ระบุ

ทรัพยากร REST: v1.customers.userLists

เมธอด
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
เพิ่มตัวจับคู่เหตุการณ์ลงในรายการผู้ใช้ตามความถี่
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
เพิ่มเอนทิตีไปยังผู้รับในรายชื่อผู้ใช้ที่จัดการโดย Ads Data Hub
create POST /v1/{parent=customers/*}/userLists
สร้างรายการผู้ใช้ที่จัดการโดย Ads Data Hub
delete DELETE /v1/{name=customers/*/userLists/*}
ลบรายการผู้ใช้ที่จัดการโดย Ads Data Hub ที่ขอ
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
สร้างการเป็นสมาชิกสําหรับ UserList
get GET /v1/{name=customers/*/userLists/*}
เรียกข้อมูลรายการผู้ใช้ที่จัดการโดย Ads Data Hub ที่ขอ
list GET /v1/{parent=customers/*}/userLists
แสดงรายชื่อผู้ใช้ที่จัดการโดยลูกค้า Ads Data Hub ที่ระบุ
patch PATCH /v1/{userList.name=customers/*/userLists/*}
อัปเดตรายชื่อผู้ใช้ที่จัดการโดย Ads Data Hub ที่ขอ
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
นําเอนทิตีออกจากผู้รับรายชื่อผู้ใช้ที่จัดการโดย Ads Data Hub

ทรัพยากร REST: v1.operations

เมธอด
cancel POST /v1/{name=operations/**}:cancel
เริ่มการยกเลิกแบบไม่พร้อมกันในการดําเนินการที่ยาวนาน
delete DELETE /v1/{name=operations/**}
ลบการดําเนินการที่ยาวนาน
get GET /v1/{name=operations/**}
รับสถานะล่าสุดของการดําเนินการที่ยาวนาน
list GET /v1/{name}
แสดงการดําเนินการที่ตรงกับตัวกรองที่ระบุไว้ในคําขอ
wait POST /v1/{name=operations/**}:wait
รอจนการดําเนินการที่ใช้เวลานานที่ระบุไว้เสร็จสิ้นหรือถึงระยะหมดเวลาที่ระบุไว้มากที่สุดแล้ว ซึ่งจะแสดงสถานะล่าสุด

ทรัพยากร REST: v1.outage

เมธอด
list GET /v1/outages
แสดงการหยุดทํางานตามลําดับการประทับเวลาที่มากไปหาน้อยและกรอบเวลามองย้อนกลับคือ 130 วัน