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

ตั้งค่าการให้สิทธิ์

Search Ads 360 API กําหนดให้คําขอทั้งหมดต้องระบุโทเค็นเพื่อการเข้าถึง OAuth 2.0 สําหรับการตรวจสอบสิทธิ์ คุณสามารถทําตามเวิร์กโฟลว์การตรวจสอบสิทธิ์ OAuth 2.0 แบบมาตรฐานเพื่อสร้างโทเค็นและส่งต่อไปยัง Search Ads 360 API เราขอแนะนําให้ใช้เวิร์กโฟลว์ที่อธิบายไว้ด้านล่างเนื่องจากเหมาะสําหรับการอัปโหลด Conversion แบบอัตโนมัติทั้งหมดและการดาวน์โหลดรายงาน

หากต้องการดูทางเลือกอื่นสําหรับเวิร์กโฟลว์ที่อธิบายไว้ด้านล่าง โปรดดูการใช้ OAuth 2.0 สําหรับแอปพลิเคชันที่ติดตั้งไว้ หรือการใช้ OAuth 2.0 สําหรับแอปพลิเคชันแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ หากคุณใช้เวิร์กโฟลว์อื่น ให้ระบุค่าต่อไปนี้เป็นพารามิเตอร์ scope เมื่อคุณขอรหัสการให้สิทธิ์ OAuth 2.0
https://www.googleapis.com/auth/doubleclicksearch
หากติดตามเส้นทางแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ ให้เพิ่มบัญชีบริการเป็นผู้ใช้ Search Ads 360

เวิร์กโฟลว์การให้สิทธิ์ที่แนะนํา

ไปที่คอนโซล Google API แล้วเลือกโปรเจ็กต์
หากยังไม่ได้สร้างโปรเจ็กต์คอนโซล Google API และข้อมูลเข้าสู่ระบบ OAuth ให้ทําตามวิธีการในสร้างโปรเจ็กต์คอนโซล Google API และข้อมูลเข้าสู่ระบบ OAuth สําหรับไคลเอ็นต์

หากต้องการค้นหารหัสไคลเอ็นต์และรหัสลับ OAuth ของโปรเจ็กต์ ให้ทําดังนี้
1. เปิดหน้าข้อมูลเข้าสู่ระบบ
2. ในคอลัมน์ชื่อ ให้คลิกชื่อไคลเอ็นต์ OAuth
3. ระบบจะแสดงรหัสไคลเอ็นต์และรหัสลับไว้ในหน้าเว็บ
เปิดเว็บเบราว์เซอร์และลงชื่อเข้าใช้ Google ด้วยบัญชี Google ที่มีสิทธิ์เข้าถึงข้อมูลใน Search Ads 360
นี่คือบัญชี Google ที่ไคลเอ็นต์ API ของคุณจะใช้เพื่อตรวจสอบสิทธิ์ด้วย Search Ads 360 หากเจ้าของบัญชี Google ลาออกจากบริษัทและคุณนําสิทธิ์การเข้าถึงของ Search Ads 360 ออกจากบัญชี คุณจะต้องทําตามเวิร์กโฟลว์การให้สิทธิ์นี้ซ้ําและระบุบัญชี Google บัญชีอื่น
รับโทเค็นการรีเฟรชโดยเรียกใช้สคริปต์ยูทิลิตีของ Search Ads 360 ดังนี้
sa360Api.py --login

โดยสคริปต์จะแนะนําขั้นตอนการใช้รหัสไคลเอ็นต์และข้อมูลลับของ OAuth เพื่อรับโทเค็นการรีเฟรช โทเค็นการรีเฟรชใช้ได้กับบัญชี Google ที่คุณลงชื่อเข้าใช้ในขั้นตอนก่อนหน้าเท่านั้น
สคริปต์จะสร้าง URL ขึ้นมาในกระบวนการนี้ และขอให้คุณไปที่ URL นั้นในเว็บเบราว์เซอร์
เมื่อเบราว์เซอร์ขอให้คุณอนุญาตให้ไคลเอ็นต์ OAuth เข้าถึงข้อมูล Search Ads 360 โปรดตรวจสอบว่าบัญชี Google ที่คุณลงชื่อเข้าใช้ไว้ก่อนหน้านี้ปรากฏขึ้น (หากลงชื่อเข้าใช้บัญชี Google หลายบัญชี ระบบอาจแสดงบัญชีอื่นของคุณ)

ในตอนท้ายของกระบวนการ สคริปต์ sa360Api.py จะแสดงสตริงที่คั่นด้วยคอมมา ค่าแรกคือรหัสไคลเอ็นต์ที่คุณระบุ ค่าที่ 2 คือรหัสลับไคลเอ็นต์ที่คุณระบุ ส่วนค่าที่ 3 คือโทเค็นการรีเฟรช ในเอาต์พุตตัวอย่างต่อไปนี้ โทเค็นการรีเฟรชจะเป็นข้อความตัวหนา ดังนี้
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
จัดเก็บรหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์ และโทเค็นการรีเฟรชไว้ในฐานข้อมูลแบ็กเอนด์หรือตําแหน่งที่ปลอดภัยอื่นๆ ที่แอปพลิเคชันเข้าถึงได้
เก็บสตริงที่คั่นด้วยคอมมาไว้ในตําแหน่งที่สะดวกหากวางแผนที่จะใช้ sa360Api.py ในการส่งคําขอ JSON ตัวอย่างไปยัง Search Ads 360 API และจะส่งสตริงทั้งหมดเป็นพารามิเตอร์ทุกครั้งที่คุณเรียกใช้สคริปต์
เพิ่มโค้ดลงในแอปพลิเคชันที่ทําสิ่งต่อไปนี้
1. ใช้รหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์ และโทเค็นการรีเฟรชเพื่อรับโทเค็นเพื่อการเข้าถึง OAuth 2.0 ใหม่
2. ส่งคําขอไปยัง Search Ads 360 API โดยใช้โทเค็นเพื่อการเข้าถึงใหม่
หากใช้ไลบรารีของไคลเอ็นต์แล้ว ส่วนถัดไปคือตั้งค่าแอปพลิเคชันจะอธิบายวิธีเพิ่มรหัสการให้สิทธิ์ลงในแอปพลิเคชัน

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