กำหนดค่าโครงการคอนโซล 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 วันทำการ นโยบายนี้มีผลกับแอปทั้งหมด

เราขอแนะนำให้แอปทั้งหมดดำเนินการตามกระบวนการยืนยันผ่าน 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

การไม่ยืนยัน 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 สำหรับแอปเดสก์ท็อปหรือเว็บแอป

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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