โทเค็นของนักพัฒนา Google Ads API แต่ละรายการจะได้รับการกำหนดระดับการเข้าถึงและ "การใช้งานที่อนุญาต" ระดับการเข้าถึงจะเป็นตัวกำหนดว่าคุณจะส่งผลต่อบัญชีที่ใช้งานจริงได้หรือไม่ รวมถึงจำนวนการดำเนินการและคำขอที่คุณดำเนินการได้ในแต่ละวัน การใช้งานที่ได้รับอนุญาตจะกำหนดฟีเจอร์ Google Ads API ที่เฉพาะเจาะจงซึ่งโทเค็นของนักพัฒนา ได้รับอนุญาตให้ใช้
ระดับการเข้าถึง
ระดับการเข้าถึงโทเค็นของนักพัฒนาซอฟต์แวร์มีอยู่ 4 ระดับตามลำดับในตาราง หากยังไม่มีสิทธิ์เข้าถึง Google Ads API คุณสามารถเริ่มต้นด้วยการลงชื่อสมัครใช้เพื่อรับโทเค็นของนักพัฒนาซอฟต์แวร์ที่มีระดับสิทธิ์เข้าถึงบัญชีทดสอบ คุณสามารถเพิ่มระดับการเข้าถึงได้โดยทำตามขั้นตอนเพิ่มเติมบางอย่างในแอปพลิเคชัน
| ระดับการเข้าถึง | เข้าถึงได้... | ขีดจำกัดการดำเนินการต่อวัน1 | วิธีการสมัคร | โดยปกติแล้วการตรวจสอบจะใช้เวลานานเท่าใด |
|---|---|---|---|---|
| ระดับการเข้าถึงบัญชีทดสอบ | บัญชีทดสอบ | การดำเนินการ 15,000 รายการ / วัน | วิธีการ | |
| ระดับการเข้าถึง Explorer | บัญชีทดสอบและบัญชีจริง | 2,880 การดำเนินการ / วันสำหรับบัญชีที่ใช้งานจริง 15,000 การดำเนินการ / วันสำหรับบัญชีทดสอบ |
วิธีการ | |
| ระดับการเข้าถึงขั้นพื้นฐาน | บัญชีทดสอบและบัญชีจริง | การดำเนินการ 15,000 รายการ / วันสำหรับทั้งบัญชีทดสอบและบัญชีจริง | วิธีการ | 5 วันทำการ |
| สิทธิ์การเข้าถึงระดับมาตรฐาน | บัญชีทดสอบและบัญชีจริง | การดำเนินการไม่จำกัด / วันสำหรับทั้งบัญชีทดสอบและบัญชีจริง | วิธีการ | 10 วันทำการ |
1 "ต่อวัน" อิงตามระยะเวลา 24 ชั่วโมงแบบเลื่อนซึ่งมีการส่งคำขอ API ด้วยโทเค็นของนักพัฒนาของคุณ แอปพลิเคชันจะได้รับข้อผิดพลาดหากส่งคำขอเกินขีดจำกัดสำหรับระดับการเข้าถึงของคุณภายใน 24 ชั่วโมงที่ผ่านมา
ระดับการเข้าถึงบัญชีทดสอบ
หลังจากลงชื่อสมัครใช้ Google Ads API ครั้งแรกเรียบร้อยแล้ว คุณจะได้รับ โทเค็นของนักพัฒนาที่มีสิทธิ์เข้าถึงบัญชีทดสอบ ซึ่งหมายความว่าโทเค็นของนักพัฒนาซอฟต์แวร์จะส่งคำขอ Google Ads API ได้เฉพาะกับบัญชีทดสอบเท่านั้น
วิธีสมัครรับระดับการเข้าถึงบัญชีทดสอบ
ทําตามขั้นตอนลงชื่อสมัครใช้ Google Ads API ในอินเทอร์เฟซเว็บของ Google Ads เพื่อรับสิทธิ์เข้าถึงบัญชีทดสอบ โดยอัตโนมัติ
ระดับการเข้าถึง Explorer
หลังจากลงชื่อสมัครใช้ Google Ads API ครั้งแรกแล้ว Google อาจ อัปเกรดโทเค็นของนักพัฒนาจากระดับสิทธิ์เข้าถึงบัญชีทดสอบเป็นระดับสิทธิ์เข้าถึง Explorer โดยอัตโนมัติในบางกรณี ระดับการเข้าถึงแบบ Explorer ช่วยให้โทเค็นของนักพัฒนาซอฟต์แวร์สามารถส่งคำขอ Google Ads API ไปยังทั้งบัญชีทดสอบและบัญชีที่ใช้งานจริง บัญชีที่ใช้งานจริงคือบัญชีที่แสดงโฆษณา Google จริงที่ใช้งานอยู่ ส่วนบัญชีทดสอบจะไม่แสดงโฆษณา
ระดับการเข้าถึงแบบ Explorer อนุญาตให้โทเค็นของนักพัฒนาแอปดำเนินการได้สูงสุด 2,880 รายการต่อวันในบัญชีที่ใช้งานจริง ซึ่งเพียงพอสำหรับนักพัฒนาซอฟต์แวร์ส่วนใหญ่ในการเริ่มต้นใช้งาน API และสร้างการทำงานอัตโนมัติขั้นพื้นฐาน
สิทธิ์การเข้าถึงระดับ Explorer จะจำกัดการเข้าถึงฟีเจอร์ต่อไปนี้ หากต้องการใช้ฟีเจอร์เหล่านี้ คุณต้องสมัครสิทธิ์การเข้าถึงระดับพื้นฐานหรือสิทธิ์การเข้าถึงระดับมาตรฐาน
| ฟังก์ชันการทำงานที่ถูกจำกัด | บริการและวิธีการที่ถูกจำกัด |
|---|---|
| การสร้างบัญชี | CustomerService.CreateCustomerClient |
| การจัดการผู้ใช้ | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| การวางแผน |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| การเรียกเก็บเงินและการชำระเงินในบัญชี |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
วิธีสมัครรับระดับการเข้าถึง Explorer
ทําการลงชื่อสมัครใช้ Google Ads API ในอินเทอร์เฟซเว็บของ Google Ads ให้เสร็จสมบูรณ์ ใน บางกรณี Google อาจอัปเกรดโทเค็นของนักพัฒนาแอปเป็นระดับการเข้าถึง Explorer โดยอัตโนมัติเมื่อคุณลงชื่อสมัครใช้เสร็จสมบูรณ์
ระดับการเข้าถึงขั้นพื้นฐาน
ระดับการเข้าถึงขั้นพื้นฐานอนุญาตให้โทเค็นของนักพัฒนาส่งคำขอ Google Ads API ไปยังทั้งบัญชีทดสอบและบัญชีที่ใช้งานจริง บัญชีที่ใช้งานจริงคือบัญชีที่แสดงโฆษณา Google จริงที่ใช้งานอยู่ ส่วนบัญชีทดสอบจะไม่แสดงโฆษณา
ระดับการเข้าถึงพื้นฐานช่วยให้โทเค็นของนักพัฒนาแอปดำเนินการได้สูงสุด 15,000 รายการ ต่อวัน ซึ่งเพียงพอสำหรับนักพัฒนาแอปส่วนใหญ่
วิธีสมัครระดับการเข้าถึงขั้นพื้นฐาน
หากคุณมีโทเค็นของนักพัฒนาที่มีสิทธิ์เข้าถึงระดับบัญชีทดสอบหรือสิทธิ์เข้าถึงระดับ Explorer คุณสามารถสมัครสิทธิ์เข้าถึงระดับพื้นฐานได้โดยทำดังนี้
ไปที่ https://ads.google.com/aw/apicenter ในเว็บเบราว์เซอร์ ลงชื่อเข้าใช้บัญชีดูแลจัดการ Google Ads หากระบบแจ้ง
ตรวจสอบว่าระดับการเข้าถึงเป็นบัญชีทดสอบหรือผู้สำรวจ
ตรวจสอบว่าอีเมลติดต่อ API ในศูนย์ API เป็นข้อมูลล่าสุด คุณ จะดำเนินการตามขั้นตอนการสมัครให้เสร็จสมบูรณ์ไม่ได้หากไม่มีอีเมลที่ถูกต้องและมีการตรวจสอบเป็นประจำ ตรวจสอบว่าคุณได้ลิงก์บัญชี Google Ads ที่ใช้งานอยู่ทั้งหมดกับบัญชีดูแลจัดการ Google Ads ด้วยโทเค็น API
คลิกลูกศรแบบเลื่อนลงข้างระดับการเข้าถึง แล้วคลิกลิงก์สมัครรับสิทธิ์เข้าถึงขั้นพื้นฐาน
ยืนยันแบรนด์ของโปรเจ็กต์ Google Cloud ให้เสร็จสมบูรณ์
Google Ads API ใช้สถานะการยืนยันแบรนด์ของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่เชื่อมโยง กับโทเค็นของนักพัฒนาขณะตรวจสอบแอปพลิเคชันสำหรับสิทธิ์การเข้าถึงระดับพื้นฐาน คุณสามารถทําตามกระบวนการยืนยันแบรนด์ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เพื่อ เร่งกระบวนการตรวจสอบแอปพลิเคชันสิทธิ์การเข้าถึงระดับพื้นฐาน ในบางกรณี Google อาจขอให้คุณทําการยืนยันแบรนด์ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google เป็นข้อกําหนดเบื้องต้นในการประมวลผลแอปพลิเคชันสิทธิ์การเข้าถึงระดับพื้นฐาน โปรดดู คู่มือการยืนยันแบรนด์เพื่อ ดูข้อมูลเพิ่มเติม
สิทธิ์การเข้าถึงระดับมาตรฐาน
สิทธิ์การเข้าถึงระดับมาตรฐานช่วยให้โทเค็นของนักพัฒนาแอปดำเนินการได้ไม่จำกัดจำนวนต่อวันสำหรับบริการส่วนใหญ่ ซึ่งรวมถึงแต่ไม่จำกัดเพียง
GoogleAdsService Search และ
SearchStream ดูรายละเอียดเพิ่มเติม
เกี่ยวกับขีดจำกัดและข้อยกเว้นสำหรับระดับการเข้าถึงมาตรฐานได้ที่โควต้า
API
ระบบจะให้สิทธิ์ระดับการเข้าถึงมาตรฐานแก่นักพัฒนาแอปที่ต้องการการดำเนินการ Google Ads API แบบไม่จำกัดเท่านั้น เช่น บริษัทขนาดใหญ่หรือเครื่องมือที่ให้บริการแก่ผู้ใช้จำนวนมาก
วิธีสมัครรับสิทธิ์การเข้าถึงระดับมาตรฐาน
หากมีโทเค็นของนักพัฒนาที่มีสิทธิ์เข้าถึงระดับพื้นฐาน คุณสามารถสมัครรับสิทธิ์การเข้าถึงระดับมาตรฐานได้โดยทำดังนี้
ไปที่ https://ads.google.com/aw/apicenter ในเว็บเบราว์เซอร์ ลงชื่อเข้าใช้บัญชีดูแลจัดการ Google Ads หากระบบแจ้ง
ตรวจสอบว่าระดับการเข้าถึงเป็นพื้นฐาน
ตรวจสอบว่าอีเมลติดต่อ API ในศูนย์ API เป็นข้อมูลล่าสุด คุณ จะดำเนินการตามขั้นตอนการสมัครให้เสร็จสมบูรณ์ไม่ได้หากไม่มีอีเมลที่ถูกต้องและมีการตรวจสอบเป็นประจำ ตรวจสอบว่าคุณได้ลิงก์บัญชี Google Ads ที่ใช้งานอยู่ทั้งหมดกับบัญชีดูแลจัดการ Google Ads ด้วยโทเค็น API
คลิกลูกศรแบบเลื่อนลงข้างระดับการเข้าถึง แล้วคลิกลิงก์สมัครรับสิทธิ์เข้าถึงมาตรฐาน
หากผู้ใช้ภายนอกใช้เครื่องมือของคุณ โปรดเตรียมพร้อมที่จะให้สิทธิ์เข้าถึงการลงชื่อเข้าใช้แบบเดโมในเครื่องมือของคุณ โปรดทราบว่าเครื่องมือของคุณต้องเป็นไปตามฟังก์ชันการทำงานขั้นต่ำที่กำหนด
โควต้า API และขีดจำกัดอัตราของระบบ
ไม่ว่าจะมีระดับการเข้าถึงใด การดำเนินการทั้งหมดของ API จะขึ้นอยู่กับอัตราของระบบ ซึ่งจำกัดจำนวนการดำเนินการที่คุณอาจทำได้ในช่วงระยะเวลาหนึ่ง ซึ่งก็คือจำนวนการดำเนินการต่อชั่วโมง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดการ ข้อผิดพลาดเกี่ยวกับอัตราการจำกัดได้ที่ประเภทข้อผิดพลาด
บริการแต่ละอย่างอาจบังคับใช้ขีดจำกัดเพิ่มเติมและข้อจำกัดด้านโควต้าเนื่องจาก เหตุผลต่างๆ เช่น ข้อจำกัดในการออกแบบผลิตภัณฑ์ ข้อจำกัดด้านนโยบายผลิตภัณฑ์ ประสิทธิภาพของ API และข้อควรพิจารณาเกี่ยวกับเวลาในการตอบสนอง ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อจำกัดเหล่านี้ได้ในเอกสารประกอบเกี่ยวกับโควต้า API
การใช้งานที่อนุญาต
การใช้งานที่อนุญาตใช้ได้กับโทเค็นของนักพัฒนาซอฟต์แวร์ที่มีสิทธิ์เข้าถึงระดับพื้นฐานและระดับมาตรฐานเท่านั้น ระบบจะจัดสรรการใช้งานที่อนุญาตตามการใช้งาน Google Ads API ที่ตั้งใจไว้ สิทธิ์เหล่านี้จะกำหนดฟีเจอร์ของ API ที่ใช้โทเค็นของนักพัฒนาซอฟต์แวร์ได้ ดังที่อธิบายไว้ในตารางต่อไปนี้
| การใช้งานที่อนุญาต | คำอธิบาย |
|---|---|
| การสร้าง / จัดการโฆษณา | ให้สิทธิ์เข้าถึงบริการทั้งหมดของ API สำหรับการสร้างและจัดการ แคมเปญ กลุ่มโฆษณา โฆษณา และคีย์เวิร์ด Google Ads |
| การรายงาน | ส่งเฉพาะคำขอ GoogleAdsService.Search
หรือ GoogleAdsService.SearchStream
หรือการเรียกแบบอ่านอย่างเดียวเท่านั้น ซึ่งเหมาะสำหรับนักพัฒนาแอปที่ใช้ API เพื่อขอสถิติเท่านั้น
|
| การค้นคว้าคีย์เวิร์ดและคำแนะนำ | อนุญาตให้โทเค็นของนักพัฒนาแอปเข้าถึง RecommendationService
KeywordPlanIdeaService
และ KeywordPlanService
ซึ่งใช้เฉพาะเครื่องมือที่ต้องมีคำแนะนำเพื่อช่วยอำนวยความสะดวกในการ
สร้างและจัดการแคมเปญ Google Ads
|
วิธีเปลี่ยนการใช้งานที่อนุญาต
หากโทเค็นของนักพัฒนาได้รับอนุมัติสำหรับระดับการเข้าถึงพื้นฐานหรือระดับการเข้าถึงมาตรฐาน คุณสามารถกรอกใบสมัครเพื่ออัปเดตการใช้งานที่อนุญาตได้ กรอกใบสมัครหากต้องการอัปเดต การใช้งานที่อนุญาต หรือให้สิทธิ์เข้าถึงเครื่องมือแก่ลูกค้า