Dokumentazioa

URL bat bidaltzea


URL bat bidaltzeko HTTP eskaera bat erabiliz (ordezkatu bilatzaileak emandako URLarekin), bidali eskaera URL honetara:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • Gehitu, eguneratu edo ezabatu den webguneko URL bat da “url-changed” balioa. Saltatutako URL bat izan eta kodetuta egon behar du URLak. Halaber, ziurtatu URLek URIen RFC-3986 estandarrak jarraitzen dituztela.
  • 8 eta 128 karaktere hamaseitarren arteko luzera eduki behar du gakoak. Gakoak honako karaktere hauek soilik izan ditzake: minuskulak (a-z), maiuskulak (A-Z), zenbakiak (0-9) eta marratxoak (-).

Adibidez, bilatzaileari jakinarazi nahi badiozu https://www.example.com/product.html eguneratu dela eta gakoa erabili nahi duzula, hau izango da URLa:

                https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=
            

HTTP eskaera bidal dezakezu arakatzailea, wget, curl edo aukerako beste metodo baten bidez. Eskaera ondo egiten bada, HTTP 200 erantzun-kode bat itzuliko da. Beste erantzun bat jasotzen baduzu, ziurtatu ez duzula gehiegitan bidali edukia eta gakoak eta URLak balio dutela eskaera berriro bidaltzeko. Bilatzaileak URLa jaso duela soilik adierazten du HTTP 200 erantzun-kodeak.

URL multzo bat bidaltzea


URL multzo bat bidaltzeko HTTP eskaera bat erabiliz, bidali POST JSON eskaera bilatzaileak emandako URLra. Ordeztu bilatzailearen ostalariaren izenarekin.

                POST /indexnow HTTP/1.1
                Content-Type: application/json; charset=utf-8
                Host: <searchengine>
                {
                  "host": "www.example.com",
                  "key": "",
                  "urlList": [
                      "https://www.example.com/url1",
                      "https://www.example.com/folder/url2",
                      "https://www.example.com/url3"
                      ]
                }
            

Gehienez 10.000 URL bidal ditzakezu argitalpeneko, HTTP eta HTTPS protokoloa duten URLak nahastuta, behar izanez gero.

HTTP eskaera bidal dezakezu wget, curl edo aukerako beste metodo baten bidez. Eskaera ondo egiten bada, HTTP 200 erantzun-kode bat itzuliko da. Beste erantzun bat jasotzen baduzu, egiaztatu eskaera eta ziurtatu informazio zuzuena duela. Ondoren, bidali eskaera berriro. Bilatzaileak URL multzoa jaso duela soilik adierazten du HTTP 200 erantzun-kodeak.

Edukiaren zati zehatz bat gehitu, eguneratu edo ezabatu ostean, gomendagarria da URLen bidalketa-prozesua automatizatzea; horretarako, ikusi erabiltzaileek sortutako edukiarekin erlazionatutako jardunbide egokiak Maiz egiten diren galeren atalean.

Jabetza egiaztatzea gakoaren bidez


URLak bidali ahal izateko, URLak bidaltzeko erabiliko duzun ostalariaren jabe zarela “egiaztatu” beharko duzu. Horretarako, testu-fitxategi bat ostatatu behar duzu gutxienez ostalarian. URLa bilatzaileetara bidali ostean, gako-fitxategia arakatuko dute jabetza egiaztatzeko eta gakoa erabiltzeko hura aldatu arte. Gogoan izan zuk eta bilatzaileek soilik dakizuela zein den gakoa eta non dagoen fitxategiaren gakoa.

Jabetza ziurtatzeko bi modu eskaintzen ditugu.

1. aukera
Ostatatu testuzko gako-fitxategi bat ostalariaren erroko direktorioan.

Horretarako, UTF-8 bidez kodetutako testuzko gako-fitxategi bat ({your-key}.txt) ostatatu behar duzu eta fitxategiko gakoa webguneko erroko direktorioan zerrendatu.

Adibidez, aurreko informazioari dagokionez, UTF-8 gako-fitxategia ostatatu behar duzu https://www.example.com/.txt fitxategian eta gakoak fitxategi horretan egon behar du.

2. aukera
Testuzko gako-fitxategia ostalarian ostatatzea.

UTF-8 bidez kodetutako testuzko gako-fitxategi bat edo gehiago ostata ditzakezu ostalari bereko beste kokalekuetan, baina gogoan izan bilatzaileei jakinarazi behar diezula testuzko gako-fitxategiaren kokalekua IndexNow jakinarazpen bakoitzean; horretarako, zehaztu kokalekua keyLocation aldagaia erabiliz.

URL bat bidaltzen baduzu, zehaztu gako-fitxategiaren kokalekua keyLocation URLen parametroen balio gisa.

                    https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=&keyLocation=http://www.example.com/myIndexNowKey63638.txt
                

URL multzo bat bidaltzen baduzu, zehaztu gako-fitxategiaren kokalekua keyLocation aldagai gisa JSON edukian.

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.com",
                      "key": "",
                      "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.com/url1",
                          "https://www.example.com/folder/url2",
                          "https://www.example.com/url3"
                          ]
                    }
                

2. aukeran, gako-fitxategiaren kokalekuak zehazten du zein URL multzo sar daitezkeen gako horretan. http://example.com/catalog/key12457EDd.txt kokalekuan dagoen gako-fitxategiekhttp://example.com/catalog/ helbidearekin hasten diren URLak eduki ditzakete, baina ezin dituzte eduki honela hasten diren URLak: http://example.com/help/.

http://example.com/catalog/sitemap.xml elementuan baliozkotzat jotzen ez diren URLak, besteak beste:

2. aukeran erabil ezin daitezkeen URLak ezin dira indexatu. Biziki gomendatzen da 1. aukera erabiltzea eta fitxategi-gakoa web-zerbitzariaren erroko direktorioan gordetzea.

Response format


HTTP Code
Response
Reasons
200
OK
URL submitted successfully
202
Accepted
URL received. IndexNow key validation pending.
400
Bad request
Invalid format
403
Forbidden
In case of key not valid (e.g. key not found, file found but key not in the file)
422
Unprocessable Entity
In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol
429
Too Many Requests
Too Many Requests (potential Spam)

Requirement for search engines


Search engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating search engines. To participate, search engines must have a noticeable presence in at least one market or be closely linked to the search market and make a significant contribution to the number of url submissions. Learn more