กำหนดค่าโครงการคอนโซล Google API สำหรับ Google Ads API

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

ดูวิดีโอนี้เพื่อดูแนวทางปฏิบัติแนะนำบางส่วนสำหรับโปรเจ็กต์ระบบคลาวด์

การยืนยัน Google OAuth

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

การยืนยันนี้เป็นอิสระและนอกเหนือจากการตรวจสอบใดๆ ที่ดำเนินการเป็นส่วนหนึ่งของกระบวนการอนุมัติโทเค็นนักพัฒนาซอฟต์แวร์ และจำเป็นเนื่องจากขอบเขต Google Ads API เป็นขอบเขตที่ละเอียดอ่อน

การยืนยันตัวตนกับ Google ไม่มีค่าใช้จ่าย โดยปกติจะใช้เวลา 3-5 วันทำการ นโยบายนี้มีผลกับแอปทั้งหมด

เราขอแนะนำให้แอปทั้งหมดผ่านกระบวนการยืนยัน Google OAuth โดยเร็วที่สุดเพื่อหลีกเลี่ยงการหยุดชะงักทางธุรกิจ

สร้างโปรเจ็กต์

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

เปิดใช้ Google Ads API ในโปรเจ็กต์

หากต้องการเปิดใช้ Google Ads API สำหรับโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

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

  2. ใช้การค้นหาเพื่อหา Google Ads API หากไม่ปรากฏในรายการ

  3. เลือก Google Ads API แล้วคลิกปุ่มเปิดใช้

เลือกประเภทผู้ใช้และสถานะการเผยแพร่

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

ประเภทผู้ใช้ สถานะการเผยแพร่ ข้อจำกัด
ภายใน การทดสอบ
  • ใช้ได้เฉพาะกับโปรเจ็กต์ที่เชื่อมโยงกับองค์กร Google Cloud เท่านั้น
  • จำกัดผู้ใช้ทดสอบสูงสุด 100 รายที่ระบุไว้ในหน้าจอความยินยอมของ OAuth
  • ผู้ใช้ทดสอบต้องเป็นผู้ใช้ภายในในองค์กร Google Cloud ที่เชื่อมโยงกับโปรเจ็กต์
  • การให้สิทธิ์จะหมดอายุใน 7 วันนับจากเวลาที่ได้รับความยินยอม
ภายนอก การทดสอบ
  • ใช้ได้กับทุกโปรเจ็กต์
  • จำกัดผู้ใช้ทดสอบสูงสุด 100 รายที่ระบุไว้ในหน้าจอความยินยอมของ OAuth
  • ผู้ใช้ทดสอบอาจเป็นผู้ใช้ที่มีบัญชี Google ก็ได้
  • การให้สิทธิ์จะหมดอายุใน 7 วันนับจากเวลาที่ได้รับความยินยอม
ภายใน ใช้งานจริง
  • ใช้ได้เฉพาะกับโปรเจ็กต์ที่เชื่อมโยงกับองค์กร Google Cloud เท่านั้น
  • อนุญาตให้ผู้ใช้ภายในองค์กร Google Cloud ที่เชื่อมโยงกับโปรเจ็กต์ ได้รับสิทธิ์
ภายนอก ใช้งานจริง
  • ใช้ได้กับทุกโปรเจ็กต์
  • อนุญาตให้สิทธิ์ผู้ใช้ทุกคนที่มีบัญชี Google

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

  1. เปิดหน้าจอขอความยินยอม แล้วเลือกโปรเจ็กต์ในเมนูแบบเลื่อนลงที่ด้านบนของหน้า

  2. เลือกประเภทผู้ใช้ แล้วคลิกสร้าง

  3. กรอกแบบฟอร์มหน้าจอคำยินยอม คุณแก้ไขข้อมูลนี้ได้ในภายหลังหากจำเป็น คลิกบันทึกและดำเนินการต่อเมื่อเสร็จแล้ว

  4. ในหน้าถัดไป ให้คลิกเพิ่มหรือนำขอบเขตออก

    • เลื่อนลงแล้วป้อนข้อมูลต่อไปนี้ในช่องใต้เพิ่มขอบเขต ด้วยตนเอง

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

    • คลิกเพิ่มลงในตาราง

    • เพิ่มขอบเขตอื่นๆ ที่โปรเจ็กต์จะขอ แล้วคลิกอัปเดต

    • คลิกบันทึกและต่อไป

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

  6. ตรวจสอบหน้าสรุปแล้วคลิกกลับไปที่แดชบอร์ด

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

เลือกประเภทแอป

ตัวเลือกประเภทแอปสำหรับ Google Ads API มี 2 ตัวเลือก ได้แก่ เดสก์ท็อปหรือเว็บ โปรดดูตารางต่อไปนี้เพื่อพิจารณาว่าประเภทใดเหมาะสมที่สุดสำหรับแอปที่คุณต้องการสร้าง

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

ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับ OAuth ของ Google Identity Platform สำหรับ แอปเดสก์ท็อปหรือ เว็บแอป

สร้างรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

เมื่อกำหนดประเภทแอปแล้ว ให้ทำตามวิธีการด้านล่างเพื่อสร้าง รหัสไคลเอ็นต์ OAuth2 และรหัสลับไคลเอ็นต์

  1. เปิดหน้าข้อมูลเข้าสู่ระบบ เลือกโปรเจ็กต์ที่สร้างไว้ก่อนหน้านี้หรือสร้างโปรเจ็กต์ใหม่

  2. ในหน้าจอข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกรหัสไคลเอ็นต์ OAuth

    1. หากก่อนหน้านี้คุณไม่ได้กำหนดค่าหน้าจอคำยินยอม OAuth สำหรับโปรเจ็กต์นี้ ระบบจะนำคุณไปกำหนดค่าในตอนนี้ คลิกกำหนดค่าหน้าจอขอความยินยอม

      1. เลือกประเภทผู้ใช้ แล้วคลิกสร้าง

      2. กรอกแบบฟอร์มเริ่มต้น คุณแก้ไขข้อมูลนี้ได้ในภายหลังหากจำเป็น คลิกบันทึกเมื่อเสร็จแล้ว

    2. กลับไปที่ข้อมูลเข้าสู่ระบบ > สร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth เพื่อดำเนินการต่อ

  3. เลือกแอปเดสก์ท็อปหรือเว็บแอปพลิเคชันเป็นประเภทแอป โดยขึ้นอยู่กับกรณีการใช้งาน

  4. ตั้งชื่อ แล้วคลิกสร้าง

  5. หากประเภทไคลเอ็นต์เป็นเว็บแอปพลิเคชัน ให้เพิ่ม URI เปลี่ยนเส้นทางที่ได้รับอนุญาตอย่างน้อย 1 รายการ

    สำหรับการทดสอบในเครื่องที่เข้ากันได้กับการกำหนดค่าเริ่มต้นใน ตัวอย่างไลบรารีไคลเอ็นต์ ให้ใช้ http://127.0.0.1

    สำหรับไคลเอ็นต์แอปบนเดสก์ท็อป คุณจะยังคงใช้ การเปลี่ยนเส้นทาง IP แบบวนรอบ แต่จะไม่มีการกำหนดค่า URI อย่างชัดเจนใน Cloud Console

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

ก่อนหน้า
ภาพรวม
ถัดไป
ไลบรารีของไคลเอ็นต์