Określa, czy istnieje określona (kierunkowa) relacja między określonymi zasobami źródłowymi i docelowymi.
Relacja opisuje intencję połączenia między tymi 2 zasobami, których dotyczy roszczenie przez zasób źródłowy. Przykładem może być przekazywanie uprawnień.
To polecenie jest najczęściej używane przez systemy infrastruktury do sprawdzania warunków wstępnych czynności. Na przykład klient może chcieć sprawdzić, czy w danym przypadku można wysyłać adresy URL do określonych aplikacji mobilnych. Klient może sprawdzić, czy link do danego zasobu ze strony internetowej do aplikacji mobilnej jest dozwolony.
Uwaga dotycząca bezpieczeństwa: jeśli jako źródło podasz zasób bezpieczny, np. stronę HTTPS lub aplikację na Androida, interfejs API upewni się, że wszystkie wyciągi użyte do wygenerowania odpowiedzi zostały wykonane przez właściciela tego zasobu w bezpieczny sposób. Jeśli natomiast z zasobu źródłowego pochodzi niezabezpieczona witryna HTTP (czyli adres URL zaczyna się od http://
zamiast https://
), interfejs API nie może bezpiecznie zweryfikować swoich instrukcji i nie można zagwarantować, że instrukcje nie zostały zmodyfikowane przez osobę trzecią. Więcej informacji znajdziesz w specyfikacji technicznej projektu Digital Asset Links.
Żądanie HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parametry zapytania
Nazwa parametru | Typ | Opis |
---|---|---|
source |
object( |
Źródło hostującej listę wyciągów. Służy ona do kierowania wywołania Check() do właściwego źródła. |
relation |
string |
Ciąg zapytania dla relacji. Identyfikujemy powiązania z ciągami znaków w formacie Aktualną listę obsługiwanych relacji znajdziesz w naszej dokumentacji interfejsu API. Aby zapytanie pasowało do linku do zasobu, obydwa ciągi muszą być identyczne. Przykład: zapytanie o relacji |
target |
object( |
Zasób docelowy wyciągu. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Odpowiedź na wywołanie CheckAssetLinks.
Zapis JSON |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
Nazwa pola | Typ | Opis |
---|---|---|
linked |
boolean |
Ustaw wartość „true”, jeśli zasoby określone w żądaniu są połączone relacją określoną w żądaniu. WYMAGANE |
maxAge |
string |
Od momentu wyświetlenia odpowiedź powinna być uznawana za prawidłową, o ile jest ona uzasadniona. WYMAGANE Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku ( |
debugString |
string |
Czytelna dla człowieka wiadomość zawierająca informacje, które pomagają użytkownikom zrozumieć, odtworzyć i debugować wynik. Wiadomość będzie w języku angielskim i nie planujemy udostępnić żadnych tłumaczeń. Pamiętaj, że nie gwarantujemy zawartości ani formatu tego ciągu znaków. Każdy aspekt usługi może ulec zmianie bez powiadomienia. Nie próbuj automatycznie analizować tych danych. Jeśli uważasz, że musisz to zrobić, ponieważ interfejs API nie zapewnia dostępu do potrzebnych informacji, najpierw skontaktuj się z nami. |
Wypróbuj
Aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź, użyj eksploratora interfejsów API.