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

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

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

• ในระหว่างขั้นตอนการให้สิทธิ์ ผู้ใช้จะเห็น UI ที่ไม่ได้รับการยืนยัน หน้าจอ

• คุณถูกจำกัดให้อนุญาตผู้ใช้เพียง 100 รายเท่านั้น

กำหนดค่าหน้าจอขอความยินยอม 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 Client-ID

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

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

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

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

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

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

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

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

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

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