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

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

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

การยืนยัน Google OAuth

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

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

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

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

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

ไปที่คอนโซล 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 ของ Callback

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

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