Search Ads 360 Reporting API เวอร์ชันเก่ากำลังจะหยุดให้บริการ และจะหยุดให้บริการในวันที่ 30 มิถุนายน 2024 โปรดทราบว่า Search Ads 360 Conversion API จะไม่ได้รับผลกระทบและจะยังคงรองรับต่อไป การพัฒนาการรายงานใหม่ทั้งหมดควรใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

ตั้งแต่เดือนเมษายน 2024 ระบบจะแสดงข้อผิดพลาดของเวอร์ชัน API ที่ไม่รองรับเมื่อขอรายงาน ดูรายละเอียดที่นี่

และเราขอแนะนำอย่างยิ่งให้คุณย้ายข้อมูลการใช้งาน Search Ads 360 ที่มีอยู่ไปยัง API ใหม่ ดูข้อมูลเพิ่มเติมได้ที่เริ่มต้นใช้งานและคู่มือการย้ายข้อมูลของ Search Ads 360 Reporting API เวอร์ชันใหม่

หน้านี้ได้รับการแปลโดย Cloud Translation API

API Reference

การอ้างอิง API นี้จัดเรียงตามประเภททรัพยากร ทรัพยากรแต่ละประเภทมีการนำเสนอข้อมูลอย่างน้อย 1 รายการและมีวิธีอย่างน้อย 1 วิธี

Conversion

โปรดดูรายละเอียดทรัพยากร Conversion ในหน้าการแสดงทรัพยากร

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/doubleclicksearch/v2 เว้นแต่จะระบุไว้เป็นอย่างอื่น
รับ	`GET /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion`	เรียกรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search พารามิเตอร์การค้นหาที่ต้องระบุ: `endDate`, `rowCount`, `startDate`, `startRow`
getByCustomerId	`GET /customer/customerId/conversion`	ดึงรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ พารามิเตอร์การค้นหาที่ต้องระบุ: `endDate`, `rowCount`, `startDate`, `startRow`
แทรก	`POST /conversion`	แทรก Conversion ใหม่เป็นกลุ่มใน DoubleClick Search
อัปเดต	`PUT /conversion`	อัปเดตกลุ่ม Conversion ใน DoubleClick Search
updateAvailability	`POST /conversion/updateAvailability`	อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search

รายงาน

สำหรับรายละเอียดของทรัพยากรรายงาน โปรดดูที่หน้าการแสดงทรัพยากร

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/doubleclicksearch/v2 เว้นแต่จะระบุไว้เป็นอย่างอื่น
generate	`POST /reports/generate`	สร้างและแสดงผลรายงานทันที
รับ	`GET /reports/reportId`	แบบสำรวจสถานะของคำขอรายงาน
getFile	`GET /reports/reportId/files/reportFragment`	ดาวน์โหลดไฟล์รายงานที่เข้ารหัสในรูปแบบ UTF-8
getIdMappingFile	`GET /agency/agencyId/advertiser/advertiserId/idmapping`	ดาวน์โหลดไฟล์ CSV (เข้ารหัส UTF-8) ที่มีการแมปรหัสระหว่าง Search Ads 360 เวอร์ชันเก่ากับ Search Ads 360 เวอร์ชันใหม่ ไฟล์สําหรับผู้ลงโฆษณาที่ขอ ไฟล์จะมีเอนทิตีย่อยทั้งหมด (เช่น บัญชีเครื่องมือค้นหา แคมเปญ กลุ่มโฆษณา) ที่มีอยู่ใน Search Ads 360 เวอร์ชันเก่าและ Search Ads 360 เวอร์ชันใหม่
คำขอ	`POST /reports`	แทรกคำขอรายงานลงในระบบการรายงาน

SavedColumns

สำหรับรายละเอียดทรัพยากรที่บันทึกไว้ โปรดดูที่หน้าการแสดงทรัพยากร

วิธีการ	คำขอ HTTP	คำอธิบาย
URI ที่สัมพันธ์กับ https://www.googleapis.com/doubleclicksearch/v2 เว้นแต่จะระบุไว้เป็นอย่างอื่น
list	`GET /agency/agencyId/advertiser/advertiserId/savedcolumns`	ดึงรายการคอลัมน์ที่บันทึกไว้ของผู้ลงโฆษณาที่ระบุ