กําหนดค่าโปรเจ็กต์คอนโซล Google API สําหรับ Google Ads API

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

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

การยืนยัน OAuth ของ Google

แอป 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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