---
title: Google'i andmed blogile
description: Google'i API-de liides: PageSpeed, Core Web Vitals, Search Console ja URL-i kontroll.
category: Marketing
sublabel: Sisu
author: AgriciDaniel
tags: 
license: MIT
source: https://github.com/AgriciDaniel/claude-blog
---

# Blogi Google: Google API andmed blogi jõudluse jaoks

Otsejuurdepääs Google'i SEO API-dele blogi jõudluse analüüsiks. Pakub tõelisi
Chrome'i kasutajamõõdikuid, indekseerimisstaatust, otsingujõudlust, olemianalüüsi, YouTube'i
videote leidmist, märksõnade mahte ja PDF/HTML jõudlusaruandeid.

Enamikul integratsioonidel pole dokumenteeritud kvootide piires kasutustasu. Cloud
Natural Language nõuab arveldust ja võib pärast tasuta kuutaset tekitada kulusid.
Google Ads nõuab sobivat kontot ja arendaja märki. Ära kunagi luba arveldust ega
tee tasulist päringut ilma kasutaja selgesõnalise heakskiiduta.

## Eeltingimused

**Kontrolli alati volitusi enne mis tahes käsu käivitamist:**
```bash
python3 skills/blog-google/scripts/run.py google_auth --check --json
```

**Konfiguratsioonifail:** `~/.config/claude-seo/google-api.json` (jagatud claude-seo-ga)
```json
{
  "api_key": "YOUR_GOOGLE_API_KEY",
  "oauth_client_path": "/path/to/client_secret.json",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789",
  "ads_developer_token": "...",
  "ads_customer_id": "123-456-7890",
  "ads_login_customer_id": "123-456-7890"
}
```

Kui puudub, loe `references/auth-setup.md` ja juhata kasutaja seadistusest läbi.

### Volituste tasemed

| Tase | Tuvastamine | Saadaolevad käsud |
|------|-----------|-------------------|
| **0** (API-võti) | `api_key` olemas | `pagespeed`, `crux`, `crux-history`, `youtube`, `nlp` |
| **1** (OAuth/SA) | + OAuth märk või teenusekonto | Tase 0 + `gsc`, `inspect`, `index` |
| **2** (täielik) | + `ga4_property_id` seadistatud | Tase 1 + `ga4` |
| **3** (Ads) | + `ads_developer_token` + `ads_customer_id` | Tase 2 + `keywords` |

Teavita alati tuvastatud tasemest enne käskude käivitamist.

## Kiirülevaade

| Käsk | Mida see teeb | Tase |
|---------|-------------|------|
| `/blog google setup` | Kontrolli/seadista API volitused |: |
| `/blog google pagespeed <url>` | PSI Lighthouse + CrUX väliandmed | 0 |
| `/blog google crux <url>` | Ainult CrUX väliandmed (p75 mõõdikud) | 0 |
| `/blog google crux-history <url>` | 25-nädalane CWV trendianalüüs | 0 |
| `/blog google youtube <query>` | YouTube'i videootsing (vaatamised, meeldimised, kestus) | 0 |
| `/blog google nlp <url-or-text>` | NLP olemiväljavõte + sentiment | 0 |
| `/blog google gsc <property>` | Search Console: klikid, näitamised, CTR, positsioon | 1 |
| `/blog google inspect <url>` | URL Inspection: indeksolek, kanooniline | 1 |
| `/blog google index <url>` | Esita URL Indexing API-le | 1 |
| `/blog google ga4 [property-id]` | GA4 orgaanilise liikluse aruanne | 2 |
| `/blog google keywords <seed>` | Märksõnaideed Google Ads Keyword Plannerist | 3 |
| `/blog google report <type>` | PDF/HTML jõudlusaruanne |: |
| `/blog google quotas` | Näita kõigi API-de päringupiiranguid |: |

---

## PageSpeed + CrUX

### `/blog google pagespeed <url>`

Kombineeritud Lighthouse laboriandmed + CrUX väliandmed avaldatud blogipostituse jaoks.

**Skript:** `python3 skills/blog-google/scripts/run.py pagespeed_check <url> --json`
**Viide:** `references/api-reference.md`

Väljund ühendab laboriskoorid (ajahetke Lighthouse) väliandmetega (28-päevased
Chrome'i kasutajamõõdikud). CrUX proovib esmalt URL-i taset, taandub päritolutasemele.

### `/blog google crux <url>`

Ainult CrUX väliandmed (Lighthouse'i käitust ei toimu). Kiirem.

**Skript:** `python3 skills/blog-google/scripts/run.py pagespeed_check <url> --crux-only --json`

### `/blog google crux-history <url>`

25-nädalane CrUX History trendid. Näitab, kas CWV mõõdikud paranevad, on stabiilsed või halvenevad.

**Skript:** `python3 skills/blog-google/scripts/run.py crux_history <url> --json`

---

## Search Console

### `/blog google gsc <property>`

Search Analytics: klikid, näitamised, CTR, positsioon viimase 28 päeva kohta.

**Skript:** `python3 skills/blog-google/scripts/run.py gsc_query --property <property> --json`
**Vaikimisi:** 28 päeva, dimensions=query,page, type=web, limit=1000.

Sisaldab kiirvõidu tuvastamist: päringud positsioonil 4-10 suurte näitamistega.

Search Console'i spetsiaalsed genereeriva-AI aruanded on järkjärguline, alamhulga
kasutuselevõtt Search Console'i kasutajaliideses. Neil on eraldi Search ja Discover
vaated; Search-vaade katab AI Overviews ja AI Mode. Ära luba klikke, päringuid
ega API-hankimist nendest spetsiaalsetest vaadetest. Kuni Google dokumenteerib API,
raporteeri see võimekus kui `SKIPPED` või kättesaamatu ja suuna kasutaja kasutajaliidesse.

Google'i 29. juuli Search Centrali teade ütleb, et Search Console'i platvormi
property'd Instagrami, TikToki, X-i ja YouTube'i jaoks on globaalselt saadaval.
Praegune abikeskus ütleb endiselt järkjärguline kasutuselevõtt. Raporteeri see Google'i-allika
konfliktina, kontrolli saadavust kasutaja kontol ja ära väida, et
`/blog google gsc` hangib need platvormiaruanded läbi praeguse API.

### `/blog google inspect <url>`

URL Inspection: tegelik indekseerimisstaatus Google'ilt.

**Skript:** `python3 skills/blog-google/scripts/run.py gsc_inspect <url> --json`

Tagastab: verdikt (PASS/FAIL), katvuse olek, robots.txt olek, indekseerimise olek,
lehe hankimise olek, kanoonilise valik, mobiilikasutatavus, rikastatud tulemused.

Pärast kanoniseerimise parandust võib Google URL-i duplikaatklastris kuni kaks
nädalat hoida. Kui rakendus on nüüd õige ja parandus on selles aknas, raporteeri
`PENDING_REEVALUATION`, mitte kohene ebaõnnestumine. Search Console'i Request Indexing
funktsioon on kvoodiga piiratud; reserveeri see oluliste URL-ide jaoks.

Partiikontrolliks: `python3 skills/blog-google/scripts/run.py gsc_inspect --batch <file> --json`

---

## Indexing API

### `/blog google index <url>`

Teavita Google'it URL-i uuendusest läbi Indexing API.

**Skript:** `python3 skills/blog-google/scripts/run.py indexing_notify <url> --json`
**Viide:** `references/api-reference.md`

Indexing API on ametlikult JobPosting ja BroadcastEvent/VideoObject lehtede jaoks.
Teavita kasutajat alati sellest piirangust. Päevane kvoot: 200 avaldamispäringut.
Ära esita seda üldotstarbelise asendusena URL Inspectioni Request Indexing
funktsioonile.

Partiina: `python3 skills/blog-google/scripts/run.py indexing_notify --batch <file> --json`

---

## GA4 liiklus

### `/blog google ga4 [property-id]`

Orgaanilise liikluse aruanne: päevased seansid, kasutajad, lehevaatamised, põrkemäär, kaasatus.

**Skript:** `python3 skills/blog-google/scripts/run.py ga4_report --property <id> --json`
**Vaikimisi:** 28 päeva, filtreeritud Organic Search kanalirühmale.

Peamiste maandumislehtede jaoks: `python3 skills/blog-google/scripts/run.py ga4_report --property <id> --report top-pages --json`

---

## YouTube (videote leidmine)

YouTube'i uuring võib lisada kasulikku, asjakohast meediat ja levituskonteksti. Igasugune
kolmanda osapoole nähtavuse korrelatsioon on vaatluslik, mitte Google'i edetabeli ega
viitamise nõue. Tasuta, ainult API-võti. Kasutavad blog-write ja blog-rewrite
video manustamiseks.

### `/blog google youtube <query>`

Otsi YouTube'ist blogiteemale asjakohaseid videoid.

**Skript:** `python3 skills/blog-google/scripts/run.py youtube_search search "<query>" --json`
**Kvoot:** 100 ühikut otsingu kohta (10 000 ühikut/päev tasuta).

Tagastab: pealkiri, kanal, vaatamised, meeldimised, kestus, kirjeldus, sildid.

Video üksikasjade + kommentaaride jaoks: `python3 skills/blog-google/scripts/run.py youtube_search video <video_id> --json`

---

## NLP sisuanalüüs

Google'i olemi- ja sentimentianalüüs saab toetada teema- ja toimetuseülevaatust.
See ei avalda edetabelisüsteemi skoore ja E-E-A-T ei ole numbriline Google'i
edetabeli tegur.

### `/blog google nlp <url-or-text>`

Täielik NLP analüüs: olemid, sentiment, sisuklassifikatsioon.

**Skript:** `python3 skills/blog-google/scripts/run.py nlp_analyze --url <url> --json`
**Tasuta tase:** 5000 ühikut/kuus. Nõuab GCP projektil lubatud arveldust.

Ainult olemiväljavõtte jaoks: `python3 skills/blog-google/scripts/run.py nlp_analyze --url <url> --features entities --json`

---

## Märksõnauuring (Google Ads)

Kuldstandardi märksõnamahu andmed. Nõuab Google Ads kontot (tase 3).

### `/blog google keywords <seed>`

Genereeri märksõnaideed seemnetest blogiteema uurimiseks.

**Skript:** `python3 skills/blog-google/scripts/run.py keyword_planner ideas "<seed>" --json`

Mahu otsingu jaoks: `python3 skills/blog-google/scripts/run.py keyword_planner volume "<kw1>,<kw2>" --json`

---

## Aruanded

### `/blog google report <type>`

Genereeri PDF/HTML aruanne graafikute ja tabelitega.

**Skript:** `python3 skills/blog-google/scripts/run.py google_report --type <type> --data <json> --domain <domain> --format pdf`

| Tüüp | Sisend | Väljund |
|------|-------|--------|
| `cwv-audit` | PSI + CrUX + CrUX History andmed | Core Web Vitals audit mõõdikute ja ajajoontega |
| `gsc-performance` | GSC päringuandmed | Search Console aruanne päringutabelitega |
| `indexation` | Partiikontrolli andmed | Indekseerimisstaatus katvuse sõõrikdiagrammiga |
| `full` | Kõik andmed koos | Põhjalik Google SEO aruanne |

**Märkus:** PDF-i genereerimine nõuab süsteemiteeke: `sudo apt install libpango1.0-dev libcairo2-dev`.
Taandub HTML-ile, kui WeasyPrint pole saadaval või PDF-i renderdus ebaõnnestub.

---

## Päringupiirangud

| API | Minutis | Päevas | Autentimine |
|-----|-----------|---------|------|
| PSI v5 | 240 QPM | 25 000 QPD | API-võti |
| CrUX + History | 150 QPM (jagatud) | Piiramatu | API-võti |
| GSC Search Analytics | 1200 QPM/sait | 30M QPD | Teenusekonto |
| GSC URL Inspection | 600 QPM | 2000 QPD/sait | Teenusekonto |
| Indexing API | 380 RPM | 200 avaldamist/päev | Teenusekonto |
| GA4 Data API | 10 samaaegset (50 360 jaoks) | 200K Core Tokens/päev (2M 360 jaoks) | Teenusekonto |
| YouTube Data |: | 10 000 ühikut/päev | API-võti |
| NLP API |: | 5000 ühikut/kuus | API-võti (arveldus) |

Loe `references/rate-limits-quotas.md` üksikasjaliku kvoodihalduse jaoks.

## Blogi töövoo integratsioon

See oskus on nii kasutaja-kutsutav (`/blog google pagespeed`) kui ka teiste blogi
alamoskuste poolt sisemiselt kutsutav:

- **blog-seo-check**: käivitab PSI + CrUX avaldatud postituse URL-il reaalajas CWV andmete jaoks
- **blog-rewrite**: NLP olemianalüüs E-E-A-T olemilünkade tuvastamiseks
- **blog-geo**: GSC jõudlusandmed tegelike otsinguilmumise ülevaadete jaoks
- **blog-audit**: partii CWV + indekseerimiskontrollid kõigi avaldatud blogi-URL-ide lõikes
- **blog-write / blog-rewrite**: YouTube'i otsing video manustamiseks

Taandub sujuvalt, kui volitused pole seadistatud.

## Aruandemallid

Kasuta kaasasolevaid malle, kui töövoog nõuab püsivat inimloetavat aruannet.
Hoia kättesaamatud kontoandmed märgituna `SKIPPED`; ära kunagi täida tühja jaotist
hinnanguliste mõõdikutega.

- `assets/templates/cwv-audit-report.md` PageSpeedi ja CrUX tõendite jaoks.
- `assets/templates/gsc-performance-report.md` Search Analyticsi ekspordi jaoks.
- `assets/templates/indexation-status-report.md` URL Inspectioni tõendite jaoks.

## Tehnilised märkused

- INP asendas FID 12. märtsil 2024. Ära kunagi viita FID-ile.
- CLS väärtused CrUX-ist on sõnena kodeeritud (nt "0.05"). Skriptid tegelevad parsimisega.
- CrUX 404 = ebapiisav Chrome'i liiklus, mitte autentimisviga.
- Search Analyticsi andmetel on 2-3 päeva viivitus.
- Indexing API on ametlikult ainult JobPosting/BroadcastEvent lehtede jaoks.
- Enamikul integratsioonidel pole kvoodi piires kasutustasu. Cloud Natural Language
  nõuab arveldust ja võib tekitada kulusid; Google Ads nõuab konto ja
  arendaja-märgi juurdepääsu.
- Loe `references/search-currentness.md` enne nimelise uuenduse, kanoonilise
  muudatuse, Discover-nähtavuse, Google'i genereeriva-AI aruandluse,
  platvormi property'de, Preferred Sources, AMP või roomaja baidipiirangu probleemi diagnoosimist.
- Nimelise uuenduse kuupäevad ei tõenda, mis põhjustas üksiku saidi muutuse.
  Oota pärast kasutuselevõttu üks täisnädal enne andmete võrdlemist ja eralda Web,
  Image, Video ja News jõudlus.
- Googlebot töötleb toetatud failidest ainult esimest 2 MB ja PDF-idest esimest 64 MB.
  Hoia kriitilised metaandmed ja põhisisu enne lõikepunkti.

## Vigade käsitlemine

| Stsenaarium | Tegevus |
|----------|--------|
| Volitusi pole seadistatud | Käivita `/blog google setup`. Loetle tase 0 käsud (ainult API-võti). |
| Teenusekontol puudub GSC juurdepääs | Lisa `client_email` GSC > Settings > Users > Add. |
| CrUX andmed kättesaamatud (404) | Ebapiisav Chrome'i liiklus. Kasuta tagavaraks PSI laboriandmeid. |
| GA4 property't ei leitud | Leia property ID GA4 Admin > Property Details. |
| Indexing API kvoot ületatud | 200/päev piirang. Prioriseeri kõige olulisemad URL-id. |
| Päringupiirang (429) | Oota ja proovi uuesti eksponentsiaalse tagasilangusega. |