WebResource

משאב אינטרנט הוא ייצוג של אתר או דומיין מאומתים.

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

לקבלת רשימה של שיטות למשאב זה, ניתן לעיין בסוף הדף.

ייצוגי משאבים

{
  "id": string,
  "site": {
    "type": string,
    "identifier": string
  },
  "owners": [
    string
  ]
}
שם הנכס ערך תיאור הערות
id string המחרוזת שמשמשת לזיהוי האתר הזה. יש להשתמש בערך הזה בחלק id של כתובת ה-URL של REST לביצוע הפעולות, עדכון ומחיקה.
owners[] list כתובות האימייל של כל הבעלים הישירים והמאומתים של הנכס המדויק הזה. בעלים עקיפים - לדוגמה, בעלים מאומתים של הדומיין המכיל את - לא נכללים ברשימה זו.
site object מאגר עבור הכתובת והסוג של אתר מאומת או שיאומת.
site.identifier string מזהה האתר בטפסים שונים, בהתאם לערך של הנכס type.
site.type string סוג האתר.

הערכים הקבילים הם:
  • "ANDROID_APP": מגדירים את identifier לכתובת URL של אפליקציה ל-Android. דוגמה: "android-app://com.google.android.youtube/"
  • &"INET_DOMAIN": יש להגדיר את identifier לשם דומיין. דוגמאות: "www.example.com", "example.com" או "subdomain.example.com"
  • "SITE": מגדירים את identifier לכתובת URL מלאה עבור שורש האתר, המסתיימת בסימן /. דוגמאות: "https://www.example.com/" או "https://www.example.com/subsite/"

שיטות

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

ניתן לראות את כל המשאבים המאומתים של המשתמש המאומת באמצעות הרשימה. ניתן גם לקבל אסימון להצבת האתר המאומת של המשתמש באתר getToken.

מחיקה
מאשר את הבעלות של המשתמש על אתר או דומיין.
הורדה
מאחזר את הנתונים העדכניים ביותר לגבי אתר או דומיין.
getToken
מקבלים אסימון אימות עבור המשתמש המאומת שיש להציב באתר או בדומיין.
insert
מאמתת את הבעלות על אתר או על דומיין.
list
קבלת רשימה של האתרים והדומיינים המאומתים של המשתמש המאומת.
עדכון
משנים את רשימת הבעלים של אתר או דומיין.