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

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

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

1. ไปที่คอนโซล Google API แล้วเลือกโปรเจ็กต์

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

   หากต้องการค้นหารหัสและรหัสลับไคลเอ็นต์ OAuth ของโปรเจ็กต์ ให้ทําดังนี้

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

   นี่คือบัญชี Google ที่ไคลเอ็นต์ API จะใช้ตรวจสอบสิทธิ์กับ Search Ads 360 หากผู้ถือบัญชี Google ออกจากบริษัทและคุณนำสิทธิ์เข้าถึง Search Ads 360 ออกจากบัญชี คุณจะต้องทําขั้นตอนการให้สิทธิ์นี้ซ้ำและระบุบัญชี Google อื่น

3. รับโทเค็นรีเฟรชโดยการเรียกใช้สคริปต์ยูทิลิตี Search Ads 360 ดังนี้

   sa360Api.py --login

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

   ในระหว่างกระบวนการนี้ สคริปต์จะสร้าง URL และบอกให้คุณไปที่ URL ในเว็บเบราว์เซอร์

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

   เมื่อสิ้นสุดกระบวนการ สคริปต์ sa360Api.py จะแสดงผลสตริงที่คั่นด้วยคอมมา ค่าแรกคือรหัสไคลเอ็นต์ที่คุณระบุ ค่าที่ 2 คือรหัสลับไคลเอ็นต์ที่คุณระบุ และค่าที่ 3 คือโทเค็นรีเฟรช ในตัวอย่างเอาต์พุตต่อไปนี้ โทเค็นรีเฟรชจะอยู่ในข้อความตัวหนา
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. จัดเก็บรหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์ และโทเค็นการรีเฟรชในฐานข้อมูลแบ็กเอนด์หรือตำแหน่งที่ปลอดภัยอื่นๆ ที่แอปพลิเคชันเข้าถึงได้

   โปรดเก็บสตริงที่คั่นด้วยคอมมาทั้งหมดไว้ในตำแหน่งที่สะดวกหากต้องการใช้ sa360Api.py เพื่อส่งคำขอ JSON ตัวอย่างไปยัง Search Ads 360 API คุณจะต้องส่งสตริงทั้งหมดเป็นพารามิเตอร์ทุกครั้งที่เรียกใช้สคริปต์

6. เพิ่มโค้ดลงในแอปพลิเคชันเพื่อดำเนินการต่อไปนี้
   1. ใช้รหัสไคลเอ็นต์ รหัสลับไคลเอ็นต์ และโทเค็นการรีเฟรชเพื่อรับโทเค็นเพื่อการเข้าถึง OAuth 2.0 ใหม่
   2. ส่งคําขอไปยัง Search Ads 360 API โดยใช้โทเค็นการเข้าถึงใหม่

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

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