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": דומיינים בלבד
  • "DNS_TXT": דומיינים בלבד
  • "FILE": אתרים בלבד
  • "META": אתרים בלבד
  • "TAG_MANAGER": אתרים בלבד

תשובה

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

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

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

נסה בעצמך!

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