Valitse sivut ja tyypit
Kartoita sivupohjat, aidosti hyödylliset skeematyypit ja kieliversiot. Hylkää sisältöön kuulumattomat tyypit.

OPAS / MENETELMÄ
Kelvollinen merkintä ei korjaa epäselvää sivua, puuttuvaa tietoa tai vahvistamatonta henkilöllisyyttä.
Suora vastaus
Aloita renderöidystä sivusta ja sen kanonisesta URL-osoitteesta. Luettele ilmoitetut entiteetit ja ominaisuudet, vertaa väitteitä näkyvään sisältöön ja tarkista sitten syntaksi sekä tavoitellun hakuominaisuuden ehdot.
01 / Tarkistusmenetelmä
Kartoita sivupohjat, aidosti hyödylliset skeematyypit ja kieliversiot. Hylkää sisältöön kuulumattomat tyypit.
Tarkista nimet, tekijät, päivät, kuvat, linkit ja suhteet näkyvästä HTML:stä ja JSON-LD:stä. Näytä tärkeä tieto lukijalle tai poista se merkinnästä.
Tarkista rakenne Schema.org-validaattorilla ja Google-ominaisuudet rich results -testillä. Erota virheet varoituksista.
Testaa pohjat ja oikeat sivut julkaisun jälkeen sekä tarkista muut kielet ja kanoniset URL-osoitteet.
KÄYTÄNNÖSSÄ
Sivu liittyy yhteenvetoon, otsikkoon, taulukoihin, linkkeihin, kieliversioihin ja rakenteiseen dataan. Korjattaessa virkettä on löydettävä sen toistot ja varmistettava merkityksen yhtenäisyys.
Valitse havaittu tilanne. Kukin vaihtoehto kertoo ensimmäisen tarkistuksen, hyödyllisen näytön ja tarkistuksen rajan.
Lisälukemista
| Tilanne | Vältä | Hyödyllinen korjaus |
|---|---|---|
| Korjattu luku | Muuttaa vain kappaleen. | Tarkistaa myös taulukko, kuvateksti, yhteenveto ja rakenteinen arvo. |
| Siirretty sivu | Muuttaa vain näkyvän linkin. | Tarkistaa kohde, ankkuri ja paluupolku. |
| Käännös | Kopioida sanat vanhentuneen esimerkin kanssa. | Tarkistaa yksikkö, päivä, lähde, linkit ja tulkinnan rajat. |
Mitkä väitteet riippuvat muutoksesta?
Mitkä sivut ja kielet toistavat ne?
Vastaavatko luvut, linkit ja rajat toisiaan?
Päivityspäivä kertoo todellisesta muokkauksesta, ei uudesta lähde- tai havaintopäivästä. Pidä näiden roolit erillään tekstissä ja viitteissä.
Luettu .
Tietojen lukemisen työpaja
DEMO-sivu on Lina DEMOn kirjoittama ranskankielinen artikkeli. DEMO-laboratorio kuvataan erillisenä organisaationa; kumpikaan ei ole todellinen.
Kuvitteellisia tietoja ja merkintöjä oppimista varten: tulokset eivät ole peräisin suorista palvelukyselyistä.
Kuvitteellinen merkintä sekoittaa identiteetin, tekijyyden ja kielen. Ulkoista tarkistinta ei ajeta: taulukko erottaa näkymästä tutkittavat asiat.
Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.
| Tarkistus | DEMO-tila | Mitä osoittaa | Tutkittava korjaus |
|---|---|---|---|
| JSON-syntaksi | Muodollisesti oikeat sulut, merkkijonot ja taulukot | Teksti voidaan jäsentää JSONiksi | Jatka merkityksen tarkistukseen. |
| @id-identiteetti | Sama #entity Linalle ja laboratoriolle | Kaksi eri kohdetta sekoittuu tässä tapauksessa | Anna kuvatuille kohteille johdonmukaiset tunnisteet. |
| Artikkelin kirjoittaja | Lina näkyy; laboratorio author-kentässä | Tekijyys eroaa sivusta | Käytä tuettua kirjoittajaa muuttamatta organisaatiota henkilöksi. |
| Ilmoitettu kieli | Ranskankielinen artikkeli; inLanguage=en | Ilmoitus koskee toista kieltä | Tarkista artikkelikohde ja tämä sivuversio. |
Avaa jokainen väite ja vertaa sen tulkintaa. Lisätarkistuksia voi silti tarvita.
Ei. Muodollisesti oikeat arvot voivat osoittaa väärään kohteeseen.
Ei. Syntaksi ei takaa kelpoisuutta eikä näyttöä.
Kyllä. Kirjaa syntaksi, toimituksellinen yhdenmukaisuus ja soveltuvat kriteerit erikseen.
Sivu: ranskankielinen DEMO-artikkeli Näkyvä kirjoittaja: Lina DEMO Virhe: #entity yhteinen henkilölle ja organisaatiolle Virhe: author osoittaa laboratorioon Virhe: inLanguage=en tällä ranskankielisellä artikkelilla Päätös: korjaa merkintä, ei vahvistettua laajennettua tulosta
#entity ja inLanguage ovat esimerkkivihjeitä, eivät havaintoja sivuston koodista eivätkä kokonainen kopioitava skeema.
02 / Säilytettävä näyttö
URL, sivutyyppi, odotettu skeema, vastuuhenkilö ja tarkistuspäivä.
Merkinnän arvo, näkyvä todiste, kentän lähde ja poikkeama.
Työkalu, testattu URL, päivä, virheet, varoitukset ja kuvakaappaus.
Korjattu tai poistettu kenttä, vastuuhenkilö ja jälkitarkistus.
TARKISTUSPISTE
Yleinen tulkintavirhe ja tarkistus, jolla se voidaan välttää.
Kelvollinen JSON-LD-syntaksi ei riitä, jos merkintä kuvaa puuttuvaa, vanhentunutta tai näkyvän sivun vastaista tietoa.
Vertaa tärkeät ominaisuudet näkyvään tekstiin, canonical-URL:ään ja odotettuun tyyppiin. Tarkista syntaksi ja hakukoneen säännöt erikseen sekä julkaistu tulos.
TARKISTUKSEN JÄLKEEN
Korjaa merkintä tai tuo väite näkyviin ja tarkistettavaksi. Oikea syntaksi ei takaa sisällön vastaavuutta.
Valitse toimituksellinen lähde, yhtenäistä kentät ja tarkista käännökset ennen uutta validointia.
Päätös ja tarkistusjälki
Mitä tarkistus auttaa päättämään ja mitä on talletettava päätöksen arvioimiseksi uudelleen.
Vertaa tuotettua JSON-LD:tä näkyvään tekstiin, canonical-osoitteeseen ja valitun tyypin ominaisuuksiin. Tarkista useita malleja ja kieliä.
Poista perusteettomat kentät, korjaa ristiriidat ja validoi valmis HTML. Dokumentoi käytetyt tyypit ja ylläpito.
Tyypillisiä tilanteita tarkistuksen suunnitteluun. Ne eivät kuvaa toteutettuja toimeksiantoja tai todellisia havaintoja.
Liitä jokainen rakenteinen ominaisuus näkyvään tietoon ja näyttöön.
Poista tukemattomat arvot; oikea syntaksi ei vahvista arviota, hintaa tai yhteyttä.
Ominaisuus, näkyvä teksti, näyttö ja valittu korjaus.
Vertaa saman @id:n esiintymiä ja identiteettitietoja sivuilla.
Varaa tunniste yhtenäiselle kohteelle; erottele henkilö, organisaatio ja sivu monistamatta saman kohteen identiteettiä.
Esiintymät, kohteet ja korjattu tunnistussääntö.
Vertaa JSON-LD-väitteitä näytettyyn tekstiin ja lähteisiin.
Poista tai korjaa ominaisuudet, joita sivu ei perustele.
Ominaisuus, näkyvä arvo, lähde ja tarkistustulos.
DOKUMENTOIDUT TIEDOT
Informatiivinen RFC 8785 määrittää JCS:n deterministisen esityksen salausoperaatioille. Se on tavallista JSONia tiukempi ja välilyöntien poistoa laajempi.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| INPUT | I-JSON · yksilölliset nimet | Ominaisuuksien nimien on oltava yksilölliset ja datan I-JSON-yhteensopivaa. Kaksoisnimen jo korvannut jäsennin voi peittää virheen: tarkista ennen tiedon menetystä. |
| WHITESPACE | ei tyhjää tokenien välissä | Tokenien väliin ei tuoteta tyhjemerkkejä. Merkkijonojen välilyönnit säilyvät; kaikkien tyhjien poistaminen raakatekstistä muuttaisi dataa. |
| NUMBERS | ECMAScript · IEEE 754 binary64 | Luvut seuraavat ECMAScriptin binary64-serialisointia. NaN ja Infinity hylätään; suurempi tarkkuus tarvitsee sopimuksen, usein nimenomaisen merkkijonon. |
| PROPERTY ORDER | rekursiivinen · UTF-16-yksiköt | Rekursiivinen järjestys vertaa purettuja nimiä etumerkittöminä UTF-16-yksikköinä ilman kielikohtaista järjestystä. UTF-8-tavujen tai koodipisteiden järjestys voi erota. |
| ARRAY ORDER | säilytetty | Taulukon elementtijärjestys säilyy, vaikka sen objektit käsitellään. Kaikkien listojen lajittelu muuttaa merkitystä. |
| UNICODE | säilytetty · UTF-8-tulos | Unicode-merkkijonot säilyvät: JCS ei käytä NFC:tä tai NFKC:tä. Lopputulos on UTF-8. Kanonisointi ja kielellinen normalisointi ovat eri muunnoksia. |
RFC 8785 § 3.2.3. Englanninkieliset nimet säilyvät lähdemuodossa. UTF-16-yksiköt tekevät järjestyksen tarkistettavaksi myös perustason ulkopuoliselle merkille.
| Koodipisteet | UTF-16-yksiköt | Lähdenimi (englanti) |
|---|---|---|
| U+000D | 000D | Carriage Return |
| U+0031 | 0031 | One |
| U+0080 | 0080 | Control |
| U+00F6 | 00F6 | Latin Small Letter O With Diaeresis |
| U+20AC | 20AC | Euro Sign |
| U+1F600 | D83D DE00 | Emoji: Grinning Face |
| U+FB33 | FB33 | Hebrew Letter Dalet With Dagesh |
RFC 8785 § 3.2.3. Copyright © 2020 IETF Trust and the persons identified as document authors. UTF-16 units added for explanation.
Nimeä JCS-tiiviste ja profiili selvästi. Se ei korvaa alkuperäisten vastaanotettujen tavujen tiivistettä; säilytä molemmat jäljitettävyyden vuoksi.
Ei yksin. Se ei tarkista kaikkia syöterajoja tai rekursiivista järjestystä. RFC:n esimerkki auttaa löytämään väärän Unicode-järjestyksen.
Dokumentaatio tarkistettu .
DOKUMENTOIDUT TIEDOT
Osittaisen päivityksen on ilmoitettava muotonsa. JSON Merge Patch kuvaa kohteeseen yhdistettäviä arvoja, JSON Patch operaatioita. Mediatyypit ja null-arvon käsittely eroavat. Simulaattori näyttää yhdistämisen kutsumatta rajapintaa.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| member absent | keep | Patchista puuttuva jäsen säilyy, kun kohde on olio. Null-arvoinen jäsen pyytää poistoa; jo puuttuvan jäsenen poisto ei lisää mitään. Tyhjä merkkijono, false ja nolla ovat arvoja, eivät poistokäskyjä. |
| member: null | delete | Oliopatch yhdistetään rekursiivisesti. Vastaava taulukko, skalaari tai null muuttuu ensin tyhjäksi olioksi. Siksi {} luvulle 7 tuottaa {}, ei lukua 7. |
| {} | object target | Muu kuin oliopatch korvaa koko kohteen kyseisellä tasolla. Taulukko korvataan kokonaan: sitä ei ketjuteta eikä kohdisteta indeksin tai tunnisteen mukaan. |
| null / [] / scalar | replace | Juuressa null-patch korvaa koko kohteen null-arvolla. Oliopatchin jäsenenä null poistaa jäsenen. JSON Patch voi sopia paremmin null-arvon nimenomaiseen asettamiseen ominaisuudelle. |
| JSON values | ≠ text diff | Laskenta koskee JSON-arvoja. Välilyönnit, sisennys ja ominaisuuksien esitysjärjestys eivät säily. Kelvollinen yhdistämistulos voi silti rikkoa rajapinnan skeemaa tai liiketoimintasääntöjä. |
Alkuperäisiä opetusesimerkkejä; oikeaa dokumenttia ei muuteta.
Kaksi JSON-arvoa, enintään 4 000 UTF-16-yksikköä kumpikin, syvyys 20 säiliötä ja 500 arvoa syötettä kohti. Luvut ovat kokonaislukuja ilman murto-osaa tai eksponenttia väliltä −9 007 199 254 740 991 – +9 007 199 254 740 991. Jäsennimet yksilöllisiä; Unicode-merkkijonoissa ei irrallisia surrogaatteja. Rajat kuuluvat työkaluun.
Paikallinen laskenta; syötettä ei lähetetä eikä tallenneta. Tulos pysyy tällä sivulla.
Simulaatio päivitetty.
{
"title": "B",
"keep": true
}| Vaihe | Alkuperäinen kohde | Sovellettava patch | Tuloksena saatu arvo |
|---|---|---|---|
| 1 | {
"title": "A",
"note": "old",
"keep": true
} | {
"note": null,
"title": "B"
} | {
"title": "B",
"keep": true
} |
| 2 | {
"items": [
"A",
"B",
"C"
]
} | {
"items": [
"B"
]
} | {
"items": [
"B"
]
} |
| 3 | [
1,
2
] | {
"x": 1
} | {
"x": 1
} |
| 4 | {
"x": 1
} | null | null |
| 5 | [] | {
"missing": null
} | [] |
| 6 | 7 | [] | [] |
| 7 | {
"a": {
"x": 1,
"y": 2
},
"z": 3
} | {
"a": {
"x": null
}
} | {
"a": {
"y": 2
},
"z": 3
} |
| 8 | {
"a": null,
"b": 5
} | {
"b": 0,
"c": false,
"d": ""
} | {
"a": null,
"b": 0,
"c": false,
"d": ""
} |
| 9 | {
"items": [
"A",
"B"
]
} | {
"items": [
"X"
]
} | {
"items": [
"X"
]
} |
| 10 | {
"__proto__": {
"x": 1
},
"constructor": 2
} | {
"__proto__": {
"y": 3
}
} | {
"__proto__": {
"x": 1,
"y": 3
},
"constructor": 2
} |
Simulaatio ei muuta resurssia eikä tarkista oikeuksia, rajapintasopimusta tai rinnakkaisia päivityksiä. Luku- ja syöterajat suojaavat selaimen tulkintaa eivätkä määrittele kaikkea JSONia. Kirjaa todellisen päivityskohteen tunniste ja versio erikseen.
Ei. Merge Patch säilyttää oliokohteen arvolla {}, mutta korvaa muun kohteen tyhjällä oliolla. Merkitys riippuu saman tason kohdetyypistä. Yhdistämisen jälkeinen skeematarkistus on erillinen tehtävä.
Dokumentaatio tarkistettu .
Kysymykset täydentävät menetelmää. Ne auttavat tunnistamaan tuetut päätelmät säilyttäen varaukset tietueessa.
Onko jokaisella merkityllä päiväyksellä, hinnalla, roolilla, arviolla ja saatavuudella perusteltu näkyvä vastine? Poista päätellyt tai vanhentuneet ominaisuudet keinotekoisen täytön sijaan.
Kuvitteellinen esimerkki: tila koskee vain kuvattua kriteeriä ja rajausta.
Läpäisevätkö tyyppi, ominaisuudet ja suhteet sopivan validaattorin? Erota merkinnän kelvollisuus, hakutoiminnon säännöt ja todella havaittu näyttö.
Kuvitteellinen esimerkki: tila koskee vain kuvattua kriteeriä ja rajausta.
Erottaako merkintä kuvitteelliset tiedot, vanhat arvot ja näkyvän tarjouksen? Harjoitusesimerkki ei saa muuttua rakenteiseksi kaupalliseksi lupaukseksi.
Tarkistettu dokumentaatio : Google Search Central · Structured data policies ·
Kuvitteellinen esimerkki: tila koskee vain kuvattua kriteeriä ja rajausta.
TYÖKALUT / REKISTERIT
Vertaa ilmoitettuja ominaisuuksia näkyvään sisältöön ja lähteisiin. Kelvollinen JSON voi olla virheellinen; tekninen validointi ei korvaa sisällön tarkistusta.
03 / FAQ
Ei. Tyypin on sovittava sivuun ja sääntöihin, ja hakukone päättää näyttämisestä.
Ei. Hyödylliset kysymykset voivat jäädä tavalliseksi HTML:ksi.
Kunkin version pitää kuvata omaa näkyvää sisältöään johdonmukaisin URL-osoittein ja kielikoodein.
Ei. Sen pitää kuvata sivua ilman väitettä, jota lukija ei voi tarkistaa.
Tutustu yhteisiin tunnisteisiin ja ominaisuuksiin. Vertaa niiden arvoja sivuston viittauksiin ja tarkista sitten malleja, jotka tuottavat ne korjaamaan syyn ja riippuvaisten tapahtumien.
04 / Viralliset lähteet
DOKUMENTOIDUT TIEDOT
Viite koskee 2020-12-murretta ja sitä tukevaa validaattoria. Esimerkit ovat opetusta. Objektisäännöt olettavat type: object; required ei yksin sitä vaadi.
| Viite | Arvo tai muoto | Mitä se yksilöi |
|---|---|---|
| $schema | https://json-schema.org/draft/2020-12/schema | URI ilmoittaa murteen; säilytä validaattorin versio. |
| properties | Ominaisuus läsnä | properties tarkistaa nimetyt kentät niiden ollessa läsnä, ei vaadi niitä. |
| required: ["id"] | Läsnäolo ≠ ei-null | required ["id"] vaatii avaimen; null on silti läsnä. |
| type: ["string", "null"] | Teksti tai JSON null | string/null sallii molemmat; läsnäolo ja puuttuvuus eroavat. |
| additionalProperties: false | Sisarmääritysten soveltamisala | additionalProperties huomioi sisarmääritykset, ei automaattisesti toista allOf-haaraa. |
| unevaluatedProperties: false | Aliskeemojen arvioimat kentät | unevaluatedProperties huomioi onnistuneiden soveltuvien aliskeemojen arvioimat kentät; tarkista tuki. |
Rakenteen kelpoisuus ei todista rekisteriä tai suhdetta. Erota syntaksi, skeema ja sisältötarkistus.
Ei: määritä objekti, required ja null-käytäntö erikseen.
Dokumentaatio tarkistettu .
SYVENTÄVÄ LUKEMINEN / KÄYTÄNTÖ
Validoija hyväksyy merkinnän, kun nimi, päivämäärä tai URL ei enää vastaa sivua. Tarkastuksen on lähestyttävä ilmoitetut tiedot ilmoitetuista tiedoista.
Päivitetty .
Tarkastellaan esineitä, niiden tunnisteita ja niiden suhteita. Tarkista lopulliset URL-osoitteet, päivämäärät ja toistuvat ominaisuudet useilla sivuilla, ja tarkista sitten ristiriidat.
Validointivaroituksella ei ole aina sama vaikutus kuin virheellisellä tiedolla. Ensisijaisuus riippuu omistuksesta, sen käytöstä ja tiedosta, jota se pyrkii edustamaan.
Rekisteri erottaa syntaasin virheen, puuttuvan omaisuuden ja perustan ristiriidan. Jokainen korjaus sisältää merkinnän ja näkyvän sivun hallinnan.