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

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

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

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

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

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

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

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

  • อีเมลติดต่อ API ที่เป็นปัจจุบัน

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

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

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

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

  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 เวอร์ชัน 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/v25/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"

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

ต่อไปนี้เป็นคำถามที่พบบ่อยเกี่ยวกับระดับการเข้าถึงที่จัดการโดย Cloud

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

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

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

คุณควรใช้ศูนย์ API ต่อไปก่อนเพื่อขอเปลี่ยนแปลงระดับการเข้าถึง 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 ให้คุณ:

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

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

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

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

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

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

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