קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כל הצהרה נוצרת מתוך מחשבה על צרכן; הצרכן בהצהרה הוא זה שקורא ומאמת הצהרה שנכתבה על ידי חשבון משתמש, ולאחר מכן נוקט פעולה על סמך אותה הצהרה. באופן ספציפי יותר, הצרכן מבצע את הפעולות הבסיסיות הבאות:
בקשה להצגת רשימת דפי חשבון מחשבון משתמש ספציפי
בודקים אם הרשימה מכילה הצהרה מסוימת שמתייחסת ליעד נתון
בודקים שהיעד בהצהרה הוא היעד (אתר או אפליקציה) שלדעתכם הוא
תבצעו את הפעולה שצוינה בהצהרה, אם תבחרו
תרחישים לדוגמה רבים צורכים הצהרות שמתייחסות אליכם מאחורי הקלעים. לדוגמה, 'קישור של אפליקציות ל-Android' משתמש בהצהרות על הרשאות קישור שנוצרו על ידי אתר מסוים כדי להפעיל קישורים ישירות לאפליקציה. אפליקציה מציינת שהיא מסכימה להיות יעד להצהרות כאלה באמצעות הוספה של קוד מיוחד (handler Intent) במניפסט שלה.
ניתן לבצע את שלבים 1 ו-2 שלמעלה – בקשה ואימות של הצהרה – בשתי דרכים: באמצעות ה-API שלנו או באופן ידני (באמצעות הטמעה משלכם).
שימוש בהצהרות באמצעות Digital Asset Links API
ה-Digital Asset Links API תומך בשתי שיטות: Check() ו-List() לחיפוש או לאימות של דפי חשבון:
Check() לוקחת מקור, יעד וקשר, ומאמתת שהמקור יוצר את ההצהרה שנשלחה לגבי היעד.
List() מפרטת את כל ההצהרות שנאמרו על ידי מקור נתון.
שימוש בדוחות באופן ידני
פרוטוקול Digital Asset Links פתוח, כך שאתם יכולים ליצור בו הטמעה בעצמכם.
כדי לצרוך הצהרות שפורסמו על ידי אתרי אינטרנט, תוכלו לשלוח בקשת HTTP GET לרשימת ההצהרה המתאימה ולנתח אותה בעצמכם. לדוגמה, רשימת דפי החשבון התואמת לאתר http://example.digitalassetlinks.org נמצאת בכתובת http://example.digitalassetlinks.org/.well-known/assetlinks.json.
כדי לצרוך הצהרות מטעם אפליקציות ל-Android, עליך לגשת למניפסט של חבילת ה-APK המתאימה. במכשירי Android, ניתן לעשות זאת באמצעות הממשק של PackageManager.
חשוב לשים לב למשמעויות הספציפיות של ההצהרות על קישורים לנכסים דיגיטליים. אם אתם לא בטוחים, כדאי לעיין במפרט הקישורים לנכסים.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-06-26 (שעון UTC)."],[[["\u003cp\u003eDigital Asset Links enable websites and apps to make statements about their relationships, which other apps and services can then verify and act upon.\u003c/p\u003e\n"],["\u003cp\u003eYou can consume these statements using the Digital Asset Links API (\u003ccode\u003eCheck()\u003c/code\u003e and \u003ccode\u003eList()\u003c/code\u003e methods) or manually by retrieving and parsing the statement list.\u003c/p\u003e\n"],["\u003cp\u003eBefore implementing your own solution, check if existing mechanisms like Android App Linking already handle your desired scenario.\u003c/p\u003e\n"],["\u003cp\u003eWebsites publish their statements in a JSON file located at \u003ccode\u003e.well-known/assetlinks.json\u003c/code\u003e, while Android app statements are found within their manifest file.\u003c/p\u003e\n"],["\u003cp\u003eFor a deeper understanding of statement meanings and the underlying protocol, refer to the Asset Links Specification.\u003c/p\u003e\n"]]],[],null,["# Consuming a statement\n\nEvery statement is designed with a *consumer* in mind; the statement consumer is the one who reads and verifies a statement made by a principal, then takes action based on that statement. More specifically, a consumer performs these basic steps:\n\n1. Request the statement list from a specific principal\n2. Check to see if the list contains a given statement against a given target\n3. Validate that the target in the statement is the target (website or app) that you think it is\n4. Perform the action specified by the statement, if you choose to\n\n[Many use cases](/digital-asset-links/v1/using) consume statements for you behind the scenes. For example, Android App Linking consumes link permission statements made by a website to enable links directly into an app. An app indicates that it agrees to be a target to any such statements by adding special code (an intent handler) in its manifest.\n| Be sure to check that your scenario doesn't have a special mechanism for consuming or implementing a statement before handling it manually.\n\nYou can perform steps 1 and 2 above --- requesting and validating a statement --- in two ways: using our API or manually (using your own implementation).\n\nConsuming statements using the Digital Asset Links API\n------------------------------------------------------\n\n**The Digital Asset Links API** supports two methods: `Check()` and `List()` to find or validate statements:\n\n- [Check()](/digital-asset-links/reference/rest) takes a source, target, and relationship and verifies that the source makes the submitted statement about the target.\n- [List()](/digital-asset-links/reference/rest) lists all statements made by a given source.\n\n| In order to use the API, you need an [API key](https://support.google.com/googleapi/answer/6158862) and you must first activate the API for your project. To do that, follow these steps:\n|\n| 1. Go to the [Google Developers Console](https://console.developers.google.com/project/_/apiui/apiview/digitalassetlinks/overview).\n|\n| The console might require you to sign in first.\n| 2. Select or create a project.If you have multiple projects, make sure that you are in the project for which you want to activate the Digital Asset Links API and click **Continue** . Or, if you do not have a project, select **Create a new project** and click **Create**.\n|\n| 3. In the Digital Asset Links API overview, click **Enable API** .\n|\n| If the API is already enabled for your project, you will see **Disable API**.\n| 4. In the left-hand menu, click on **Credentials** and either select or create an API key.\n|\n| [More information about creating API keys](https://support.google.com/googleapi/answer/6158862).\n\nConsuming statements manually\n-----------------------------\n\nThe Digital Asset Links protocol is open, so you can create an implementation of it for yourself.\n\nTo consume statements made by **web sites** , you can make an HTTP GET request for the corresponding statement list and parse it yourself. For example, the corresponding statement list for the web site `http://example.digitalassetlinks.org` is at `http://example.digitalassetlinks.org/.well-known/assetlinks.json`.\n\nTo consume statements made by **Android apps** , you need to access the manifest of the corresponding APK package. On Android devices, this can be accomplished using the [PackageManager](http://developer.android.com/reference/android/content/pm/PackageManager.html) interface.\n\nPlease pay special attention to the specific meanings of Digital Asset Links statements. Refer to the [Asset Links Specification](https://github.com/google/digitalassetlinks/blob/master/well-known/details.md) if you are unsure."]]
