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

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

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

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

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

สิ่งที่ต้องดำเนินการก่อน

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

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

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

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

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

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

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

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

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

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