โทเค็นของนักพัฒนา Google Ads API แต่ละรายการจะได้รับการกำหนดระดับการเข้าถึงและ "การใช้งานที่อนุญาต" ระดับการเข้าถึงจะเป็นตัวกำหนดว่าคุณจะส่งผลต่อบัญชีที่ใช้งานจริงได้หรือไม่ รวมถึงจำนวนการดำเนินการและคำขอที่คุณดำเนินการได้ในแต่ละวัน การใช้งานที่ได้รับอนุญาตจะกำหนดฟีเจอร์ Google Ads API ที่เฉพาะเจาะจงซึ่งโทเค็นของนักพัฒนา ได้รับอนุญาตให้ใช้
ระดับการเข้าถึง
ระดับการเข้าถึงโทเค็นของนักพัฒนาซอฟต์แวร์มี 4 ระดับตามที่ระบุไว้ในตาราง หากยังไม่มีสิทธิ์เข้าถึง Google Ads API คุณสามารถเริ่มต้นด้วยการลงชื่อสมัครใช้เพื่อรับโทเค็นของนักพัฒนาที่มีระดับการเข้าถึงบัญชีทดสอบ คุณสามารถเพิ่มระดับการเข้าถึงได้โดยทำตาม ขั้นตอนเพิ่มเติมบางอย่างในแอปพลิเคชัน
| ระดับการเข้าถึง | เข้าถึง... ได้ | ขีดจำกัดการดำเนินการต่อวัน1 | วิธีการสมัคร | โดยปกติแล้วการตรวจสอบจะใช้เวลานานเท่าใด |
|---|---|---|---|---|
| ระดับการเข้าถึงบัญชีทดสอบ | บัญชีทดสอบ | การดำเนินการ 15,000 รายการ / วัน | วิธีการ | |
| ระดับการเข้าถึง Explorer | บัญชีทดสอบและบัญชีจริง | 2,880 การดำเนินการ / วันสำหรับบัญชีที่ใช้งานจริง 15,000 การดำเนินการ / วันสำหรับบัญชีทดสอบ |
วิธีการ | |
| ระดับการเข้าถึงขั้นพื้นฐาน | บัญชีทดสอบและบัญชีจริง | การดำเนินการ 15,000 รายการ / วันสำหรับทั้งบัญชีทดสอบและบัญชีจริง | วิธีการ | 2 วันทำการ |
| ระดับการเข้าถึงมาตรฐาน | บัญชีทดสอบและบัญชีจริง | การดำเนินการไม่จำกัด / วันสำหรับทั้งบัญชีทดสอบและบัญชีจริง | วิธีการ | 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 หากได้รับข้อความแจ้ง
ตรวจสอบว่าระดับการเข้าถึงเป็นบัญชีทดสอบหรือExplorer
ตรวจสอบว่าอีเมลติดต่อ API ในศูนย์ API เป็นข้อมูลล่าสุด คุณ จะดำเนินการสมัครให้เสร็จสมบูรณ์ไม่ได้หากไม่มีอีเมลที่ถูกต้องและมีการตรวจสอบเป็นประจำ ตรวจสอบว่าคุณได้ลิงก์บัญชี Google Ads ที่ใช้งานอยู่ทั้งหมดกับบัญชีดูแลจัดการ Google Ads ที่มีโทเค็น API
คลิกลูกศรแบบเลื่อนลงข้างระดับการเข้าถึง แล้วคลิกลิงก์สมัครรับสิทธิ์เข้าถึงขั้นพื้นฐาน
ระดับการเข้าถึงมาตรฐาน
สิทธิ์การเข้าถึงระดับมาตรฐานช่วยให้โทเค็นของนักพัฒนาแอปดำเนินการได้ไม่จำกัดจำนวนต่อวันสำหรับบริการส่วนใหญ่ ซึ่งรวมถึงแต่ไม่จำกัดเพียง
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 เท่านั้นที่จะใช้ข้อมูลนี้
|
วิธีเปลี่ยนการใช้งานที่อนุญาต
หากโทเค็นของนักพัฒนาได้รับอนุมัติสำหรับระดับการเข้าถึงพื้นฐานหรือระดับการเข้าถึงมาตรฐาน คุณสามารถกรอกใบสมัครเพื่ออัปเดตการใช้งานที่อนุญาตได้ กรอกใบสมัครหากต้องการอัปเดต การใช้งานที่อนุญาตหรือให้สิทธิ์เข้าถึงเครื่องมือแก่ลูกค้า