Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Każde stwierdzenie zostało zaprojektowane z myślą o konsumentach. Konsument to osoba, która czyta i weryfikuje oświadczenie złożone przez podmiot zabezpieczeń, a następnie na podstawie tego oświadczenia podejmuje odpowiednie działania. Mówiąc dokładniej, konsument wykonuje te podstawowe czynności:
Prośba o listę zestawienia operacji od konkretnego podmiotu zabezpieczeń
Sprawdź, czy lista zawiera określone wyrażenie względem danej wartości docelowej
Udowodnij, że celem wymienionym w deklaracji jest cel (witryna lub aplikacja), który Twoim zdaniem jest tym celem
Jeśli chcesz, wykonaj czynność określoną w instrukcji
W wielu przypadkach użycia wyrażenia te są odczytywane w tle. Na przykład funkcja łączenia aplikacji na Androida korzysta z instrukcji uprawnień do linków przygotowanych przez stronę internetową, aby umożliwiać bezpośrednie linki do aplikacji. Aplikacja wskazuje, że wyraża zgodę na kierowanie się takim instrukcją, dodając w pliku manifestu specjalny kod (moduł obsługi intencji).
Kroki 1 i 2 powyżej (żądanie i weryfikacja oświadczenia) możesz wykonać na 2 sposoby: za pomocą naszego interfejsu API lub ręcznie (korzystając z własnej implementacji).
Korzystanie z instrukcji za pomocą interfejsu Digital Asset Links API
Interfejs Digital Asset Links API obsługuje 2 metody: Check() i List() do znajdowania i weryfikowania instrukcji:
Check() bierze pod uwagę źródło, miejsce docelowe i relację oraz sprawdza, czy źródło składa oświadczenie dotyczące elementu docelowego.
List() zawiera wszystkie instrukcje podane w danym źródle.
Ręczne korzystanie z instrukcji
Protokół Digital Asset Links jest otwarty, więc możesz samodzielnie utworzyć jego implementację.
Aby przetwarzać instrukcje przygotowane przez witryny internetowe, możesz wysłać żądanie HTTP GET dla odpowiedniej listy instrukcji i przeanalizować ją samodzielnie. Na przykład odpowiednia lista instrukcji dla witryny http://example.digitalassetlinks.org ma adres http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Aby wykorzystać instrukcje przygotowane przez aplikacje na Androida, musisz uzyskać dostęp do pliku manifestu odpowiedniego pakietu APK. Na urządzeniach z Androidem można to zrobić za pomocą interfejsu PackageManager.
Zwróć szczególną uwagę na konkretne znaczenia deklaracji dotyczących linków do zasobów cyfrowych. Jeśli nie masz pewności, zapoznaj się ze specyfikacją linków do zasobów.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
