Method assetlinks.check

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

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

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

הערה בנושא אבטחה: אם מציינים נכס מאובטח כמקור, למשל אתר HTTPS או אפליקציה ל-Android, ה-API יבטיח שכל ההצהרות המשמשות ליצירת התגובה נשלחו בצורה מאובטחת על ידי הבעלים של הנכס. לעומת זאת, אם נכס המקור הוא אתר HTTP לא מאובטח (כלומר, כתובת ה-URL מתחילה ב-http:// במקום ב-https://), ל-API אין אפשרות לאמת את ההצהרות שלו באופן מאובטח, ואין אפשרות לוודא שהצהרות האתר לא שונו על ידי צד שלישי. מידע נוסף זמין במפרט הטכני של קישורים דיגיטליים לנכסים.

בקשת HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

פרמטרים של שאילתה

שם הפרמטר סוג תיאור
source object(Asset) המקור המארח את רשימת הדוחות. משמש להפניית הקריאה של Check() למקור הנכון.
relation string

מחרוזת שאילתה עבור הקשר.

אנחנו מזהים קשרים עם מחרוזות בפורמט <kind>/<detail>, שבהן <kind> חייב להיות אחת מתוך קבוצה של קטגוריות יעדים מוגדרות מראש, ו-<detail> היא מחרוזת אלפאנומרית של צורה קטנה המתארת את השימוש הספציפי בביטוי.

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

כדי ששאילתה תתאים לקישור נכס, גם מחרוזות היחס של השאילתה וגם של הקישור לנכס צריכות להיות זהות.

דוגמה: שאילתה עם יחס delegate_permission/common.handle_all_urls מתאימה לקישור נכס עם יחס delegate_permission/common.handle_all_urls.
target object(Asset) נכס היעד של ההצהרה.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם התגובה הצליחה, גוף התגובה מכיל נתונים במבנה הבא:

הודעת תגובה לקריאה ל-CheckAssetLinks.

ייצוג JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
שם השדה סוג תיאור
linked boolean הערך של הפרמטר הזה צריך להיות true אם הנכסים שצוינו בבקשה מקושרים על ידי הקשר שצוין בבקשה. חובה
maxAge string

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

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
debugString string

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

ההודעה תהיה באנגלית ואנחנו לא מתכננים להציע כרגע תרגומים.

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

רוצה לנסות?

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