תיעוד

שליחת כתובת URL אחת

לשליחת כתובת URL באמצעות בקשת HTTP (החל את בכתובת ה-URL שסופקה על ידי מנוע החיפוש), הגישו את הבקשה לכתובת ה-URL הבאה:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            

• url-changed היא כתובת ה-URL של אתר האינטרנט שלך, אשר נוסף, עודכן או נמחק. כתובת URL חייבת להיות URL-escaped ומקודדת ויש לוודא שכתובות ה-URL עומדות בתקני RFC-3986 לכתובות URI.
• המפתח חייב להיות באורך של לפחות 8 ומקסימום 128 תווים הקסדצימלים. המפתח יכול להכיל אך ורק את התווים הבאים: אותיות קטנות באנגלית (a-z), אותיות גדולות באנגלית (A-Z), מספרים (0-9) ומקפים (-).

לדוגמה, אם ברצונך להודיע למנועי חיפוש שהכתובת https://www.example.com/product.html עודכנה, וברצונך להשתמש במפתח זה כתובת ה-URL שלך תהיה:

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

באפשרותך להגיש בקשת HTTP באמצעות הדפדפן, wget‏, curl או מנגנון אחר לפי בחירתך. בקשה מוצלחת תחזיר קוד תגובה HTTP 200, אם קיבלת תגובה אחרת, ודא שאינך שולח לעתים קרובות מידי, שהמפתח וכתובת ה-URL חוקיים ושלח שנית את הבקשה. קוד התגובה HTTP 200 רק מציין שמנוע החיפוש קיבל את כתובת ה-URL שלך.

שליחת קבוצה של כתובות URL

כדי לשלוח קבוצה של כתובות URL באמצעות בקשת HTTP הגש את בקשת POST JSON לכתובת ה-URL שסיפקו מנועי החיפוש. החלף את בשם המארח של מנוע החיפוש.

                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"
                      ]
                }
            

באפשרותך לשלוח עד 10,000 כתובות URL לכל הודעה, תוך שילוב כתובות URL מסוג http ו-https במידת הצורך.

באפשרותך להגיש בקשת HTTP באמצעות wget‏, curl או מנגנון אחר לפי בחירתך. בקשה מוצלחת תחזיר קוד תגובה HTTP 200; אם קיבלת תגובה אחרת, עליך לבדוק את הבקשה ואם הכול נראה תקין, לשלוח שנית את הבקשה. קוד התגובה HTTP 200 רק מציין שמנוע החיפוש קיבל את קבוצת כתובות ה-URL שלך.

הדרך המומלצת היא לבצע אוטומציה של שליחת כתובות ה-URL מיד עם ההוספה, העדכון או המחיקה של שתוכן עד למגבלה מסוימת; ראה שיטות עבודה מומלצות לתוכן בהפקת המשתמש בשאלות הנפוצות.

אימות בעלות דרך המפתח

כדי לשלוח כתובות URL, עליך „להוכיח“ בעלות של המארח שעבורו כתובות ה-URL נשלחות על ידי אירוח קובץ טקסט אחד לפחות במארח. לאחר שליחת כתובות ה-URL למנועי חיפוש, מנועי החיפוש יסרקו את קובץ המפתח לאימות בעלות וישתמשו במפתח עד שתשנה את המפתח. רק אתה ומנועי החיפוש אמורים לדעת את המפתח ומיקום קובץ המפתח שלך.

אנו מציעים שתי דרכים לאימות בעלות.

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

                    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"
                          ]
                    }