ตั้งค่าและใช้ OAuth

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

Local Services API ใช้โปรโตคอล OAuth 2.0 เพื่อตรวจสอบสิทธิ์ผู้ใช้ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับ OAuth 2.0 โปรดดูการใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs

กำหนดค่าโปรเจ็กต์คอนโซล Google API สำหรับ Local Services API

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

หากต้องการรับข้อมูลเข้าสู่ระบบเหล่านี้ ให้ทำตามขั้นตอนต่อไปนี้

1. สร้างโปรเจ็กต์ โดยไปที่คอนโซล Google API คลิกสร้าง โปรเจ็กต์ ป้อนชื่อ แล้วคลิกสร้าง

2. วิธีเปิดใช้ Local Services API ในโปรเจ็กต์

   1. เปิดคลัง API ในคอนโซล Google API หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่ คลัง API แสดง API ที่พร้อมใช้งานทั้งหมด โดยจัดกลุ่มตาม ตระกูลผลิตภัณฑ์และความนิยม

      หากไม่เห็น Local Services API ในรายการ ให้ใช้ช่องค้นหา เพื่อค้นหา

   2. เลือก Local Services API แล้วคลิกเปิดใช้

3. เลือกประเภทแอป Local Services API ใช้ประเภทแอปเดียวกันกับ Google Ads API ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทแอปที่จะใช้ได้ที่เลือกประเภทแอป

4. สร้างรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ สําหรับ Local Services API ให้ทําตาม ขั้นตอนเดียวกันเพื่อสร้างรหัสไคลเอ็นต์และ รหัสลับไคลเอ็นต์ ที่ใช้สําหรับ Google Ads API ขั้นตอนจะเหมือนกันสำหรับทั้ง 2 กรณีการใช้งาน

ใช้ไลบรารีของไคลเอ็นต์เพื่อรับโทเค็น OAuth 2.0

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

วิธีรับโทเค็นการรีเฟรช OAuth 2.0

เราขอแนะนำให้คุณใช้ไลบรารีของไคลเอ็นต์ใน การใช้งานจริงเพื่อตรวจสอบสิทธิ์ผู้ใช้ หากต้องการใช้ไคลเอ็นต์ HTTP เพื่อวัตถุประสงค์ในการทดสอบ ให้ทำตามวิธีการต่อไปนี้เพื่อรับโทเค็นการรีเฟรช OAuth 2.0 และโทเค็นเพื่อการเข้าถึง ขั้นตอนที่ 1, 2 และ 3 เป็นวิธีการตั้งค่าแบบครั้งเดียวที่คุณต้องดำเนินการด้วยตนเอง ส่วนขั้นตอนที่ 4 และ 5 สามารถตั้งค่าให้ทำงานโดยอัตโนมัติในภายหลังได้โดยไม่ต้องมีการแทรกแซงจากมนุษย์ เช่น งาน cron

1. ดาวน์โหลดและติดตั้ง curl เครื่องมือบรรทัดคำสั่งเพื่อส่งคำขอ HTTP ไปยังเว็บ

2. ทำตามวิธีการในหน้า OAuth Playground เพื่อ รับโทเค็นการรีเฟรช OAuth 2.0 ใช้ขอบเขตต่อไปนี้สำหรับ Local Services API

   https://www.googleapis.com/auth/adwords
   

   ซึ่งเป็นขอบเขต OAuth 2.0 เดียวกันกับที่ Google Ads API ใช้

   เมื่อสิ้นสุดขั้นตอนนี้ คุณจะได้รับโทเค็น 2 รายการ ได้แก่ โทเค็นการรีเฟรชและโทเค็นเพื่อการเข้าถึง บันทึกทั้ง 2 รายการ

3. เรียกใช้คำสั่งต่อไปนี้ในพรอมต์คำสั่งเพื่อยืนยันว่าขั้นตอนก่อนหน้า สำเร็จ

   curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>
   

   หากเอาต์พุตของคำสั่งแสดงข้อความต่อไปนี้ แสดงว่าสำเร็จ

   {
     "azp": "************-********************************.apps.googleusercontent.com",
     "aud": "************-********************************.apps.googleusercontent.com",
     "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
     "exp": "1611183382",
     "expires_in": "3482",
     "access_type": "offline"
   }
   

   หากมีข้อผิดพลาดหรือขอบเขตไม่ถูกต้อง ให้ลองสร้างโทเค็นอีกครั้ง

4. สร้างโทเค็นเพื่อการเข้าถึงใหม่โดยไม่ต้องดำเนินการด้วยตนเอง ซึ่งเป็นสิ่งสำคัญ เนื่องจากโทเค็นเพื่อการเข้าถึงจะหมดอายุทุกชั่วโมง โทเค็นการรีเฟรชจะหมดอายุนานกว่ามาก ดังนั้นคุณจึงมักต้องเพิกถอนด้วยตนเองเมื่อไม่จำเป็นต้องใช้แล้ว

   หากต้องการรับโทเค็นเพื่อการเข้าถึงใหม่ ให้เรียกใช้คำสั่งต่อไปนี้

   curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”
   

5. เรียกใช้ API ต่อไปนี้

   curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>
   

   หากโทรออกสำเร็จ แสดงว่าการตั้งค่าเสร็จสมบูรณ์แล้ว