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

หมายเหตุ: Google กำลังรับสมัครผู้เข้าร่วมโปรแกรมนี้ ลงชื่อสมัครใช้

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

• อีเมลสำหรับติดต่อ API ที่เป็นข้อมูลล่าสุด

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

ลงชื่อสมัครเข้าร่วมโปรแกรมนำร่อง

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

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

1. Google จะสร้างทรัพยากรขององค์กรในระบบคลาวด์ที่เป็นของ 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

ดาวน์โหลดและติดตั้งไลบรารี .NET ของ Google Ads API เวอร์ชัน 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/v20/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 Console เพื่อใช้ 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. คุณสร้างบัญชี Cloud Identity รุ่นใช้งานฟรีของ Google Cloud

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

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

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

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

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

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

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

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

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