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

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

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

การยืนยัน Google OAuth

แอป Google Cloud ที่ใช้เพื่อรับข้อมูลเข้าสู่ระบบสำหรับขอบเขต Google Ads API จะต้องได้รับการยืนยัน OAuth ของ Google เพื่อหลีกเลี่ยงหน้าจอ 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

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

  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 แบบ Loopback แต่ไม่มีการกำหนดค่า URI อย่างชัดเจนในคอนโซล Cloud

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

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