Paano gamitin ang Google Search Console API?

Q: Paano gamitin ang Google Search Console API?

Mag-set up ng Cloud project, i-enable ang API, mag-authorise gamit ang OAuth, at saka mag-query ng performance data, URL Inspection at mga sitemap. Narito ang mga hakbang at ang mga quota.

Gumawa ng project sa Google Cloud console, i-enable ang Google Search Console API, gumawa ng OAuth 2.0 credentials, at mag-sign in gamit ang Google account na may access sa property. Pagkatapos, maaari kang magpadala ng mga request sa apat na resource: Search Analytics para sa clicks, impressions, CTR at position; URL Inspection para sa index status; Sitemaps; at Sites. Hindi sapat ang API key lamang: bawat tawag ay nangangailangan ng OAuth token, at nililimitahan ng mga quota kung gaano karami ang maaari mong hilingin.

Ano ang saklaw ng API, at ano ang hindi

Resource	Mga method	Gamitin para sa
Search Analytics	`query`	Mga row ng performance ayon sa query, page, bansa, device, search appearance, petsa o oras
URL Inspection	`index.inspect`	Ang naka-index na bersyon ng isang URL: coverage, huling crawl, mga canonical
Sitemaps	`list`, `get`, `submit`, `delete`	Pamamahala sa mga sitemap na isinumite ng isang property
Sites	`list`, `get`, `add`, `delete`	Ang mga property sa account na naka-sign in

Iyan na ang buong API. Walang endpoint ang Links, Crawl stats, ang Page indexing report at ang Core Web Vitals report, kaya nananatili ang mga ito sa loob ng interface ng Search Console. Iniuulat ng URL Inspection kung ano ang nasa index ng Google, hindi isang live na pagsubok ng page.

I-set up ang access

Sa Google Cloud console, gumawa o pumili ng project.
I-enable ang Google Search Console API para sa project na iyon.
I-configure ang OAuth consent screen at gumawa ng OAuth client ID.
Humiling ng scope: https://www.googleapis.com/auth/webmasters.readonly para magbasa, o https://www.googleapis.com/auth/webmasters para makapag-submit o makapag-delete rin ng mga sitemap.
Mag-sign in gamit ang account na may pahintulot sa property. Kailangan ng hindi bababa sa read access para makabasa ng performance data; nakikita ng API ang eksaktong nakikita ng account na iyon.

Ang una mong Search Analytics query

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
}

Ang site ay nasa path, naka-URL-encode: sc-domain:example.com para sa Domain property, o ang eksaktong prefix kasama ang trailing slash, gaya ng https://www.example.com/, para sa URL-prefix property. Ang mga pinakamahalagang field:

Mga petsa ay inclusive at nasa Pacific Time.
type ay web bilang default; ang iba pa ay image, video, news, googleNews at discover. Bawat isa ay nangangailangan ng sariling request.
Mga filter ay inilalagay sa dimensionFilterGroups, na may mga operator mula equals at contains hanggang includingRegex at excludingRegex (RE2 syntax).
rowLimit ay mula 1 hanggang 25,000 (default 1,000); ang startRow ang nagpa-page sa natitira.
dataState ay final bilang default; ang all ay nagdaragdag ng bago at hindi pa tapos na mga araw, at ang hourly_all ay gumagana sa dimension na hour.

Bawat row ay nagbabalik ng keys, clicks, impressions, ctr (0 hanggang 1) at position, nakaayos ayon sa clicks maliban kung magpapangkat ka ayon sa petsa.

Ang mga limitasyong humuhubog sa code mo

50,000 row bawat araw bawat search type. Mag-page gamit ang startRow sa hakbang na 25,000 at huminto kapag walang laman ang response. Para makuha ang pinakamarami, mag-query ng isang araw sa bawat pagkakataon.
Load quota. Ang pagpapangkat o pag-filter ayon sa page at query nang magkasama ang pinakamahal na request, at mas mahal ang mahahabang saklaw ng petsa kaysa sa maiikli. Kapag lumampas ka sa short-term quota, hihilingin ng Google na maghintay ka ng 15 minuto.
Rate ng request. 1,200 query kada minuto kada site at kada user; 40,000 kada minuto at 30,000,000 kada araw kada project.
Quota ng URL Inspection. 2,000 inspeksyon kada araw at 600 kada minuto para sa bawat property.
16 na buwan ng history, at karaniwang available ang data dalawa hanggang tatlong araw pagkatapos ng araw.
Hindi nagsusuma ang mga row sa mga kabuuan. Hindi isinasama sa mga row na pang-query ang mga bihirang query, at iba ang bilang ng impressions kapag nagpangkat ayon sa page kumpara sa pagpapangkat ayon sa property, kaya basahin ang mga kabuuan mula sa request na walang dimension na query.

Mga karaniwang pagkakamali

Ang paggamit ng http:// kapag ang property ay https://, o ang pagkalimot sa trailing slash, ay nagbibigay ng permission error kahit may access ang account.
Tinatanggihan ang paghiling ng URL na wala sa property sa URL Inspection: dapat nasa ilalim ng siteUrl na ipinasa mo ang URL.
Ang isang buwang pinangkat ayon sa query at page sa isang tawag ay nagbabalik lamang ng mga nangungunang row. Mas maraming row ang ibinabalik ng mga pang-araw-araw na request.

Paano nakakatulong ang AutoPSEO

Kung ayaw mong panatilihin ang OAuth at pagination, kumokonekta ang AutoPSEO sa pamamagitan ng Google sign-in at inilalantad ang parehong data sa pamamagitan ng sarili nitong REST API sa /v1 (na may OpenAPI 3.1 na dokumento) at isang MCP server, na inaawtorisahan ng API key mula sa Account → API keys. May mga read-only na key, ang search analytics endpoint ay nagbabalik ng hanggang 5,000 row kada tawag, at binibilang ng mga tool ng app para sa URL Inspection ang quota ng Google na 2,000 kada araw para sa iyo. Tingnan ang MCP at mga API key. Para mapanatili ang data nang lampas 16 na buwan nang hindi nagsusulat ng pipeline, tingnan ang gaano katagal itinatago ng Search Console ang data.

Mga pinagmulan: API reference ng Google, Search Analytics query method, mga limitasyon sa paggamit, pagkuha ng lahat ng data mo at gabay sa awtorisasyon.