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 ของโปรเจ็กต์ ให้ทําดังนี้
- เปิดหน้าข้อมูลเข้าสู่ระบบ
- ในคอลัมน์ชื่อ ให้คลิกชื่อไคลเอ็นต์ OAuth
- รหัสและรหัสลับไคลเอ็นต์จะแสดงอยู่ในหน้าดังกล่าว
- เปิดเว็บเบราว์เซอร์ แล้วลงชื่อเข้าใช้ 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 คุณจะต้องส่งสตริงทั้งหมดเป็นพารามิเตอร์ทุกครั้งที่เรียกใช้สคริปต์ - เพิ่มโค้ดลงในแอปพลิเคชันเพื่อดำเนินการต่อไปนี้
- ใช้รหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์ และโทเค็นการรีเฟรชเพื่อรับโทเค็นเพื่อการเข้าถึง OAuth 2.0 ใหม่
- ส่งคําขอไปยัง Search Ads 360 API โดยใช้โทเค็นการเข้าถึงใหม่
หากคุณกำลังใช้ไลบรารีของไคลเอ็นต์ ส่วนถัดไปคือตั้งค่าแอปพลิเคชันของคุณจะอธิบายวิธีเพิ่มรหัสการให้สิทธิ์นี้ลงในแอปพลิเคชันของคุณ
หากคุณไม่ได้ใช้ไลบรารีไคลเอ็นต์ใดเลย โปรดดูคำแนะนำในการรับโทเค็นการเข้าถึงใหม่ในหัวข้อการใช้ OAuth 2.0 สําหรับแอปพลิเคชันที่ติดตั้ง