Korzystanie z wyciągu

Każde stwierdzenia są zaprojektowane z myślą o konsumentach, którzy czytają i weryfikują wszystkie oświadczenia, a następnie podejmują działania na ich podstawie. Konkretnie chodzi o:

  1. Wyślij prośbę o listę wyciągów do określonego podmiotu zabezpieczeń
  2. Sprawdź, czy na liście znajdują się dane instrukcje dotyczące danego miejsca docelowego.
  3. Potwierdź, że dane miejsce docelowe w raporcie jest wartością docelową (witryną lub aplikacją), którą uważasz za odpowiednią
  4. Wykonaj czynność podaną w instrukcji, jeśli zdecydujesz się

Wiele przypadków użycia używa scen zza kulis. Na przykład funkcja łączenia aplikacji na Androida wykorzystuje deklaracje uprawnień linków utworzone przez witrynę, aby włączyć linki bezpośrednio do aplikacji. Aplikacja wskazuje, że jest miejscem docelowym takich deklaracji, dodając w manifeście specjalny kod (moduł intencji).

Czynności z punktów 1 i 2, opisane powyżej, możesz poprosić o weryfikację i ją zweryfikować. Możesz to zrobić na dwa sposoby: za pomocą interfejsu API lub ręcznie (za pomocą własnej implementacji).

Korzystanie z raportów za pomocą interfejsu Digital Asset Links API

Interfejs Digital Asset Links API obsługuje 2 metody: Check() i List() do wyszukiwania i weryfikowania instrukcji:

  • Check() pobiera źródło, element docelowy i relację, a następnie sprawdza, czy źródło przekazuje przesłane oświadczenie dotyczące.
  • List() wyświetla wszystkie stwierdzenia wykonane przez dane źródło.

Korzystanie z wyciągów ręcznie

Protokół Digital Asset Links jest otwarty, dzięki czemu możesz utworzyć go samodzielnie.

Aby korzystać z wyciągów utworzonych na podstawie witryn internetowych, możesz wysłać żądanie HTTP GET dla odpowiedniej listy instrukcji i samodzielnie je przeanalizować. Na przykład lista instrukcji dla witryny http://example.digitalassetlinks.org znajduje się pod adresem http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Aby odczytywać oświadczenia aplikacji na Androida, musisz otworzyć plik manifestu odpowiedniego pakietu APK. Na urządzeniach z Androidem możesz to zrobić za pomocą interfejsu PackageManager.

Zwróć szczególną uwagę na konkretne znaczenie instrukcji Digital Asset Links. Jeśli nie masz pewności, zapoznaj się ze specyfikacją linków do zasobów.