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

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

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

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

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

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

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

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

  • องค์กร Google Cloud

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

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

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

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

มีช่วงพักสำหรับเลือกเข้าร่วมโปรแกรมนำร่องนี้หรือไม่

ไม่มี Google Ads 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 เพื่อให้คุณ จึงไม่ถูกเรียกเก็บเงิน

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

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

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

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

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

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