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 dwoma zasobami zgodnie z roszczeniem dotyczącym zasobu źródłowego. Przykładem takich relacji jest przekazywanie uprawnień lub uprawnień.

To polecenie jest najczęściej używane przez systemy infrastruktury do sprawdzania warunków wstępnych działania. Klient może na przykład chcieć się dowiedzieć, czy może wysłać adres URL do konkretnej aplikacji mobilnej. Klient może sprawdzić, czy na stronie internetowej znajduje się link do odpowiedniego komponentu, który prowadzi do aplikacji mobilnej, i ustalić, czy taka operacja jest dozwolona.

Uwaga dotycząca bezpieczeństwa: jeśli jako źródło podasz bezpieczny zasób, np. witrynę HTTPS lub aplikację na Androida, interfejs API zagwarantuje, że wszystkie instrukcje użyte do wygenerowania odpowiedzi zostały wykonane przez właściciela tego zasobu w bezpieczny sposób. Jeśli natomiast zasobem źródłowym jest niezabezpieczona witryna HTTP (tzn. adres URL zaczyna się od http:// zamiast https://), interfejs API nie może bezpiecznie weryfikować instrukcji i nie można upewnić się, że instrukcje witryny nie zostały zmienione przez osobę trzecią. Więcej informacji znajdziesz w specyfikacji technicznych linków do zasobów cyfrowych.

Żądanie HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Parametry zapytania

Nazwa parametru Typ Opis
source object(Asset) Źródło hostujące listę instrukcji. Służy do kierowania wywołania funkcji Check() do odpowiedniego źródła.
relation string

Ciąg zapytania dla relacji.

Identyfikujemy relacje z ciągami znaków w formacie <kind>/<detail>, gdzie <kind> musi być jedną ze wstępnie zdefiniowanych kategorii przeznaczenia, a <detail> to swobodny ciąg alfanumeryczny, który opisuje określony przypadek użycia wyrażenia.

Bieżącą listę obsługiwanych relacji znajdziesz w dokumentacji interfejsu API.

Aby zapytanie odpowiadało linkowi do zasobu, ciągi relacji w zapytaniu i linku do zasobu muszą być dokładnie takie same.

Przykład: zapytanie z relacją delegate_permission/common.handle_all_urls pasuje do linku zasobu z relacją delegate_permission/common.handle_all_urls.
target object(Asset) Docelowy komponent wyciągu.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Komunikat z odpowiedzią na wywołanie CheckAssetLinks.

Zapis JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Nazwa pola Typ Opis
linked boolean Ustaw wartość „true” (prawda), jeśli zasoby określone w żądaniu są połączone przez relację określoną w żądaniu. WYMAGANE
maxAge string

Po jakim czasie od wyświetlenia odpowiedź ma być uznawana za prawidłową, z wyłączeniem dalszych aktualizacji. WYMAGANE

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
debugString string

Zrozumiały dla człowieka komunikat zawierający informacje, które pomogą użytkownikom zrozumieć, odtworzyć i debugować wynik.

Wiadomość będzie w języku angielskim. Obecnie nie planujemy oferować żadnych tłumaczeń.

Pamiętaj, że nie możemy zagwarantować co najmniej 1 z treści ani formatu tego ciągu znaków. Jego każdy aspekt może ulec zmianie bez powiadomienia. Nie należy podejmować prób programowej analizy tych danych. Jeśli uważasz, że musisz to zrobić, ponieważ informacje, których potrzebujesz, nie są ujawniane przez interfejs API, najpierw skontaktuj się z nami.

Wypróbuj

Użyj Eksploratora interfejsów API, aby wywołać tę metodę w przypadku bieżących danych i zobaczyć odpowiedź.