ใช้งาน Google Search Console API อย่างไร

Q: ใช้งาน Google Search Console API อย่างไร

สร้างโปรเจกต์ Cloud เปิดใช้งาน API ยืนยันสิทธิ์ด้วย OAuth จากนั้นดึงข้อมูลประสิทธิภาพ การตรวจสอบ URL และ Sitemap ดูขั้นตอนและโควต้าได้ที่นี่

Google Search Console เทียบกับเครื่องมืออื่น

สร้างโปรเจกต์ใน Google Cloud console เปิดใช้งาน Google Search Console API สร้างข้อมูลรับรอง OAuth 2.0 แล้วลงชื่อเข้าใช้ด้วยบัญชี Google ที่มีสิทธิ์เข้าถึงพร็อพเพอร์ตี้ จากนั้นคุณจะส่งคำขอไปยังทรัพยากรสี่ประเภทได้ ได้แก่ Search Analytics สำหรับคลิก การแสดงผล CTR และตำแหน่ง, URL Inspection สำหรับสถานะการจัดทำดัชนี, Sitemaps และ Sites เพียงคีย์ API อย่างเดียวใช้งานไม่ได้ ทุกการเรียกต้องมีโทเค็น OAuth และโควต้าจะจำกัดปริมาณข้อมูลที่ขอได้

สิ่งที่ API ครอบคลุม และสิ่งที่ไม่ครอบคลุม

ทรัพยากร	เมธอด	ใช้สำหรับ
Search Analytics	`query`	แถวข้อมูลประสิทธิภาพแยกตามคำค้นหา หน้า ประเทศ อุปกรณ์ รูปแบบการแสดงผลในการค้นหา วันที่ หรือชั่วโมง
URL Inspection	`index.inspect`	เวอร์ชันที่จัดทำดัชนีของ URL หนึ่งรายการ ได้แก่ การครอบคลุม การรวบรวมข้อมูลครั้งล่าสุด และ canonical
Sitemaps	`list`, `get`, `submit`, `delete`	จัดการ Sitemap ที่พร็อพเพอร์ตี้ส่งไว้
Sites	`list`, `get`, `add`, `delete`	พร็อพเพอร์ตี้ในบัญชีที่ลงชื่อเข้าใช้

นี่คือทั้งหมดที่ API มีให้ ลิงก์ สถิติการรวบรวมข้อมูล รายงานการจัดทำดัชนีหน้าเว็บ และรายงาน Core Web Vitals ไม่มีเอ็นด์พอยต์รองรับ จึงดูได้เฉพาะในอินเทอร์เฟซของ Search Console เท่านั้น URL Inspection แสดงสิ่งที่อยู่ในดัชนีของ Google ไม่ใช่การทดสอบหน้าเว็บแบบสด

ตั้งค่าการเข้าถึง

ใน Google Cloud console ให้สร้างหรือเลือกโปรเจกต์
เปิดใช้งาน Google Search Console API สำหรับโปรเจกต์นั้น
กำหนดค่าหน้าจอขอความยินยอม OAuth และสร้าง OAuth client ID
ขอ scope: https://www.googleapis.com/auth/webmasters.readonly สำหรับอ่านข้อมูล หรือ https://www.googleapis.com/auth/webmasters หากต้องการส่งหรือลบ Sitemap ด้วย
ลงชื่อเข้าใช้ด้วยบัญชีที่มีสิทธิ์บนพร็อพเพอร์ตี้ การอ่านข้อมูลประสิทธิภาพต้องมีสิทธิ์อ่านอย่างน้อยที่สุด และ API จะเห็นข้อมูลเท่ากับที่บัญชีนั้นเห็น

คิวรี Search Analytics ครั้งแรกของคุณ

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

ระบุไซต์ในพาธโดยเข้ารหัส URL ใช้ sc-domain:example.com สำหรับพร็อพเพอร์ตี้แบบโดเมน หรือใช้พรีฟิกซ์ที่ตรงกันทุกตัวอักษรพร้อมเครื่องหมายทับท้าย เช่น https://www.example.com/ สำหรับพร็อพเพอร์ตี้แบบพรีฟิกซ์ URL ฟิลด์ที่สำคัญที่สุดมีดังนี้

วันที่ รวมวันที่ระบุทั้งต้นและปลาย และใช้เวลาแปซิฟิก
type ค่าเริ่มต้นคือ web ส่วนค่าอื่นได้แก่ image, video, news, googleNews และ discover โดยแต่ละประเภทต้องแยกคำขอ
ตัวกรอง ใส่ไว้ใน dimensionFilterGroups โดยมีตัวดำเนินการตั้งแต่ equals และ contains ไปจนถึง includingRegex และ excludingRegex (ไวยากรณ์ RE2)
rowLimit มีค่าตั้งแต่ 1 ถึง 25,000 (ค่าเริ่มต้น 1,000) และใช้ startRow เพื่อแบ่งหน้าดึงแถวที่เหลือ
dataState ค่าเริ่มต้นคือ final ส่วน all จะรวมวันล่าสุดที่ข้อมูลยังไม่สมบูรณ์ และ hourly_all ใช้ร่วมกับมิติ hour

แต่ละแถวจะส่งคืน keys, clicks, impressions, ctr (0 ถึง 1) และ position เรียงตามจำนวนคลิก เว้นแต่คุณจะจัดกลุ่มตามวันที่

ขีดจำกัดที่มีผลต่อโค้ดของคุณ

50,000 แถวต่อวันต่อประเภทการค้นหา ใช้ startRow แบ่งหน้าครั้งละ 25,000 แถว และหยุดเมื่อได้การตอบกลับที่ว่างเปล่า หากต้องการข้อมูลให้ได้มากที่สุด ให้คิวรีทีละวัน
โควต้าโหลด การจัดกลุ่มหรือกรองตามทั้งหน้าและคำค้นหาเป็นคำขอที่หนักที่สุด และช่วงวันที่ยาวใช้ทรัพยากรมากกว่าช่วงสั้น หากเกินโควต้าระยะสั้น Google จะให้รอ 15 นาที
อัตราคำขอ 1,200 คิวรีต่อนาทีต่อไซต์และต่อผู้ใช้ และ 40,000 ต่อนาทีและ 30,000,000 ต่อวันต่อโปรเจกต์
โควต้า URL Inspection 2,000 ครั้งต่อวันและ 600 ครั้งต่อนาทีสำหรับแต่ละพร็อพเพอร์ตี้
ประวัติย้อนหลัง 16 เดือน และโดยทั่วไปข้อมูลจะพร้อมใช้งานหลังสิ้นสุดวันนั้นสองถึงสามวัน
ผลรวมของแถวไม่เท่ากับยอดรวม คำค้นหาที่พบน้อยจะไม่ปรากฏในแถวระดับคำค้นหา และการจัดกลุ่มตามหน้านับการแสดงผลต่างจากการจัดกลุ่มตามพร็อพเพอร์ตี้ ดังนั้นควรอ่านยอดรวมจากคำขอที่ไม่มีมิติคำค้นหา

ข้อผิดพลาดที่พบบ่อย

ใช้ http:// ทั้งที่พร็อพเพอร์ตี้เป็น https:// หรือไม่ใส่เครื่องหมายทับท้าย จะเกิดข้อผิดพลาดด้านสิทธิ์ แม้บัญชีจะมีสิทธิ์เข้าถึงแล้วก็ตาม
การขอ URL ที่อยู่นอกพร็อพเพอร์ตี้ใน URL Inspection จะถูกปฏิเสธ เพราะ URL ต้องอยู่ภายใต้ siteUrl ที่คุณส่งไป
การจัดกลุ่มข้อมูลทั้งเดือนตามคำค้นหาและหน้าในการเรียกครั้งเดียวจะได้เฉพาะแถวบนสุดเท่านั้น คำขอรายวันจะให้ผลลัพธ์มากกว่า

AutoPSEO ช่วยได้อย่างไร

หากคุณไม่อยากดูแล OAuth และการแบ่งหน้าเอง AutoPSEO เชื่อมต่อผ่านการลงชื่อเข้าใช้ด้วย Google และเปิดให้เข้าถึงข้อมูลเดียวกันผ่าน REST API ของ AutoPSEO เองที่ /v1 (พร้อมเอกสาร OpenAPI 3.1) และ เซิร์ฟเวอร์ MCP โดยยืนยันสิทธิ์ด้วยคีย์ API จาก Account → API keys มีคีย์แบบอ่านอย่างเดียวให้ใช้ เอ็นด์พอยต์ search analytics ส่งคืนได้สูงสุด 5,000 แถวต่อการเรียก และเครื่องมือ URL Inspection ในแอปจะนับโควต้า 2,000 ครั้งต่อวันของ Google ให้คุณ ดู MCP และคีย์ API หากต้องการเก็บข้อมูลไว้นานกว่า 16 เดือนโดยไม่ต้องเขียนไปป์ไลน์เอง ดู Search Console เก็บข้อมูลไว้นานเท่าใด

แหล่งที่มา: API reference, เมธอด Search Analytics query, ขีดจำกัดการใช้งาน, การดึงข้อมูลทั้งหมดของคุณ และ คู่มือการให้สิทธิ์ ของ Google