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

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

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

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

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

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

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

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

  • องค์กร 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 ให้กับคุณ จะมีขั้นตอนเพิ่มเติมที่เกี่ยวข้องอีก 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

ดาวน์โหลดและติดตั้งไลบรารี 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/v16/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 ต่อไปเพื่อขอการเปลี่ยนแปลงระดับการเข้าถึง 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 Free Edition แล้ว:

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

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

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

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

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

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

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

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

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