ระดับการเข้าถึงที่จัดการโดยระบบคลาวด์

ฟีเจอร์นี้ช่วยให้องค์กร Google Cloud จัดการระดับการเข้าถึง API ได้ ซึ่งจะมีประโยชน์ดังต่อไปนี้

  • ไม่ต้องรักษาความปลอดภัยให้กับโทเค็นของนักพัฒนาแอปอีกต่อไป: การจัดการการเข้าถึง API จะดำเนินการผ่านองค์กร Google Cloud คุณจึงไม่ต้องกังวลเรื่องการรักษาความปลอดภัยให้กับโทเค็นของนักพัฒนาแอปหรือการรั่วไหลของโทเค็นอีกต่อไป คุณข้ามการส่งโทเค็นของนักพัฒนาแอปในการเรียก API ได้ แต่ยังคงต้องส่งโทเค็นการเข้าถึง

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

  • การตรวจสอบและการจัดการโควต้าที่ละเอียดยิ่งขึ้น: คุณสามารถตรวจสอบการใช้งาน API ของโปรเจ็กต์แต่ละโปรเจ็กต์ หรือจำกัดการใช้งาน API

ข้อกำหนดเบื้องต้น

  • โทเค็นของนักพัฒนาแอปที่ได้รับอนุมัติ

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

  • องค์กร Google Cloud

    Google Ads API จะเชื่อมโยงโทเค็นของนักพัฒนาแอปกับองค์กร Google Cloud และจะใช้โทเค็นดังกล่าวเพื่อกำหนดระดับการเข้าถึง API การสร้างองค์กร Google Cloud ทำได้หลายวิธี

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

  • เตรียมโปรเจ็กต์คอนโซล Google API สำหรับโปรแกรมนำร่อง

    คุณต้องเตรียมโปรเจ็กต์คอนโซล Google API ที่ใช้กับ Google Ads API สำหรับโปรแกรมนําร่อง ดังนี้

    สถานการณ์ ขั้นตอน
    คุณเป็นเจ้าขององค์กร Google Cloud หรือสร้างองค์กรในขั้นตอนก่อนหน้าแล้ว ตรวจสอบว่าโปรเจ็กต์คอนโซล Google API ทั้งหมดที่คุณเปิดใช้ Google Ads API อยู่ภายใต้องค์กรนี้ หากไม่ใช่ ให้ย้ายข้อมูลภายใต้องค์กร

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

  • อีเมลติดต่อ API ที่อัปเดตล่าสุด

    ตรวจสอบว่าอีเมลสำหรับติดต่อ Google Ads API เป็นข้อมูลล่าสุด รายละเอียดผู้ติดต่อ API จะแสดงอยู่ในหน้า API Center ของบัญชีดูแลจัดการ Google Ads API ลงชื่อเข้าใช้ จากนั้นไปที่เครื่องมือและการตั้งค่า > การตั้งค่า > API Center

ลงชื่อสมัครใช้โปรแกรมนำร่อง

ลงชื่อสมัครเข้าร่วมโปรแกรมนำร่อง จากนั้นทีมปฏิบัติตามข้อกำหนดของ Google จะตรวจสอบใบสมัครและส่งอีเมลแจ้งสถานะการอนุมัติและรายละเอียดเพิ่มเติมไปยังอีเมลติดต่อสำหรับ API

หากคุณขอให้ Google สร้างองค์กร Google Cloud ให้คุณ คุณต้องดำเนินการเพิ่มเติมอีก 2-3 ขั้นตอน ดังนี้

  1. Google จะสร้างทรัพยากรองค์กร Cloud ของ Google ให้คุณ ผู้ดูแลระบบทั้งหมดของบัญชีดูแลจัดการ Google Ads API จะได้รับบทบาท roles/resourcemanager.projectCreator ในองค์กรที่สร้างขึ้นใหม่

  2. Google จะส่งอีเมลถึงอีเมลติดต่อสำหรับ API ของคุณพร้อมรายละเอียดของทรัพยากรองค์กรที่สร้างขึ้นใหม่

  3. คุณต้องลงชื่อเข้าใช้บัญชีคอนโซล Google API แล้วทําตามวิธีการเพื่อย้ายโปรเจ็กต์คอนโซล Google API ไปยังองค์กรใหม่

  4. ตอบอีเมลเพื่อแจ้งให้ Google ทราบว่าโปรเจ็กต์ของคุณย้ายไปอยู่ในองค์กรใหม่แล้ว

  5. ทีมปฏิบัติตามข้อกำหนดของ Google จะตรวจสอบใบสมัครและส่งอีเมลแจ้งสถานะการอนุมัติและรายละเอียดเพิ่มเติมไปยังอีเมลติดต่อสำหรับ API ของคุณ

แก้ไขคําขอ API

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

Java

พร้อมให้บริการในเร็วๆ นี้

.NET

ดาวน์โหลดและติดตั้ง Google Ads API .NET library เวอร์ชัน 17.1.0 ขึ้นไป

ต่อไป ให้แก้ไขโค้ดดังนี้

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

พร้อมให้บริการในเร็วๆ นี้

Python

พร้อมให้บริการในเร็วๆ นี้

Ruby

พร้อมให้บริการในเร็วๆ นี้

Perl

พร้อมให้บริการในเร็วๆ นี้

ไคลเอ็นต์ HTTP (REST)

ละเว้นส่วนหัว developer-token ในคำขอ HTTP

curl -i -X POST https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

คำถามที่พบบ่อย

การเปลี่ยนแปลงนี้หมายความว่าฉันต้องเป็นลูกค้า Google Workspace หรือ Google Cloud จึงจะใช้ Google Ads API ได้ใช่ไหม

ไม่ได้ คุณต้องมีองค์กร Google Cloud ซึ่งทำได้หลายวิธี ข้อกําหนดนี้คล้ายกับที่คุณต้องมีโปรเจ็กต์คอนโซล Google API เพื่อใช้ Google Ads API ในปัจจุบัน

ฉันต้องการเปลี่ยนระดับการเข้าถึง API ฉันจะทำได้อย่างไร

ขณะนี้คุณควรใช้ API Center ต่อไปเพื่อขอเปลี่ยนแปลงระดับการเข้าถึง API

การเลือกเข้าร่วมโปรแกรมนําร่องนี้ทำให้ระบบหยุดทำงานไหม

ไม่มี Google Ads API จะเริ่มใช้ระดับการเข้าถึง API ระดับองค์กรโดยอัตโนมัติเมื่อได้รับอนุมัติ

การเข้าร่วมโปรแกรมนำร่องนี้ต้องใช้ความพยายามมากเพียงใด

คาดว่าจะมีการเปลี่ยนแปลงโค้ดเล็กน้อย นักพัฒนาแอปส่วนใหญ่ควรทำการเปลี่ยนแปลงแอปให้เสร็จสมบูรณ์ได้ภายในเวลาไม่ถึง 30 นาที

ระบบจะเรียกเก็บเงินจากฉันไหมหากเลือกใช้โปรแกรมนำร่องนี้

โดยทั่วไปแล้ว ระบบจะไม่เรียกเก็บเงินจากคุณหากเลือกใช้โปรแกรมนำร่องนี้ Google Ads API ให้บริการโดยไม่มีค่าใช้จ่าย และ Google จะไม่เปลี่ยนแปลงรูปแบบการกำหนดราคาของ Google Ads API

สถานการณ์ที่เป็นไปได้ในการรับองค์กร Google Cloud มีดังนี้

  1. คุณเป็นลูกค้า Google Workspace หรือ Google Cloud Identity อยู่แล้ว

    ระบบจะเรียกเก็บเงินจากคุณตามปกติสำหรับการใช้งานผลิตภัณฑ์เหล่านั้นตามปกติ ระบบจะไม่เรียกเก็บเงินจากคุณสำหรับการสร้างองค์กร Google Cloud เพื่อเข้าร่วมโปรแกรมนำร่องนี้

  2. คุณสร้างบัญชี Google Cloud Identity รุ่นใช้งานฟรี

    ระบบจะไม่เรียกเก็บเงินจากคุณเมื่อลงชื่อสมัครใช้บัญชี Google Cloud Identity รุ่นไม่มีค่าใช้จ่ายหรือสร้างองค์กร Google Cloud เพื่อเข้าร่วมโปรแกรมนำร่องนี้

  3. Google ได้สร้างทรัพยากรองค์กรในระบบคลาวด์ให้คุณแล้ว

    ทรัพยากรนี้เป็นทรัพยากรขององค์กรภายใน Cloud ที่ Google จัดการ ดังนั้นระบบจะไม่เรียกเก็บเงินจากคุณ

ฉันมีโทเค็นนักพัฒนาแอปหลายรายการสำหรับเครื่องมือต่างๆ โปรแกรมนำร่องนี้จะส่งผลต่อฉันอย่างไร

ระบบไม่รองรับกรณีการใช้งานนี้ คุณจึงเข้าร่วมโปรแกรมนำร่องนี้ไม่ได้

การดําเนินการนี้ส่งผลต่อการให้สิทธิ์ API ที่มีอยู่สําหรับบัญชีที่ฉันจัดการโดยใช้ Google Ads API ไหม

ไม่ การเปลี่ยนแปลงนี้ไม่ส่งผลต่อการให้สิทธิ์ API ที่มีอยู่กับบัญชี Google Ads ที่คุณจัดการโดยใช้ Google Ads API

ฉันเลือกใช้โปรแกรมนำร่องนี้และพบปัญหาหรือมีข้อเสนอแนะ ฉันจะติดต่อทีมสนับสนุนได้อย่างไร

ติดต่อทีม Google Ads API โดยใช้หน้าการสนับสนุนด้านเทคนิคของ API และอธิบายลักษณะของปัญหา ระบุรายละเอียด เช่น รหัสองค์กร รวมถึงบันทึกคำขอและการตอบกลับ หากเป็นไปได้