Method assetlinks.check

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(Asset) Ź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 <kind>/<detail>, gdzie <kind> musi być jedną ze zdefiniowanych wstępnie kategorii, a <detail> to dowolny ciąg znaków alfanumerycznych, który opisuje konkretny przypadek użycia wyrażenia.

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 delegate_permission/common.handle_all_urls pasuje do linku do zasobu o relacji delegate_permission/common.handle_all_urls.

target object(Asset) 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 (s). Przykład: "3.5s".

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.