WebResource: getToken

נדרשת הרשאה

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

שליחת בקשה

בקשת HTTP

POST https://www.googleapis.com/siteVerification/v1/token

הרשאה

לבקשה זו נדרשת הרשאה עם היקף הרשאות אחד לפחות (מידע נוסף על אימות והרשאה).

ההיקף
https://www.googleapis.com/auth/siteverification
https://www.googleapis.com/auth/siteverification.verify_only

גוף הבקשה

בגוף הבקשה, יש לספק את הנתונים במבנה הבא:

{
  "site": {
    "type": string,
    "identifier": string
  },
  "verificationMethod": string
}
שם הנכס ערך תיאור הערות
site object מאגר הכתובת והסוג של האתר שבהם ייווצר אסימון אימות.
site.type string סוג המשאב לאימות.

הערכים הקבילים הם:
  • "ANDROID_APP"
  • "INET_DOMAIN"
  • "SITE"
site.identifier string מזהה האתר. אם הסוג מוגדר ל-SITE, המזהה הוא כתובת URL. אם הסוג שהוגדר הוא INET_DOMAIN, המזהה הוא שם דומיין.
verificationMethod string שיטת האימות המשמשת את מערכת אימות האתרים לאימות של האתר או הדומיין.

הערכים הקבילים הם:
  • "ANALYTICS":  אתרים בלבד
  • "DNS": במקום זאת, אפשר להשתמש ב-DNS_TXT
  • "DNS_CNAME": Domains בלבד
  • "DNS_TXT": Domains בלבד
  • "FILE": Sites בלבד
  • "META": Sites בלבד
  • "TAG_MANAGER": Sites בלבד

תשובה

אם השיטה הזו מוצלחת, היא מחזירה גוף תגובה עם המבנה הבא:

{
  "method": string,
  "token": string
}
שם הנכס ערך תיאור הערות
method string שיטת האימות שבחרתם בבקשה.

הערכים הקבילים הם:
  • "ANALYTICS"
  • "DNS"
  • "DNS_CNAME"
  • "DNS_TXT"
  • "FILE"
  • "META"
  • "TAG_MANAGER"
token string המחרוזת שתתווסף לאתר המאומת של המשתמש, באמצעות שיטת האימות שנבחרה. מידע נוסף זמין במאמר שיטות אימות ואסימונים במסמך 'תחילת העבודה'.

רוצה לנסות?

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