Method: hashList.get
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ハッシュリストの最新のコンテンツを取得します。ハッシュリストは、脅威リストまたはグローバル キャッシュなどの脅威以外のリストのいずれかです。
これは https://google.aip.dev/131 で定義されている標準の Get メソッドであり、HTTP メソッドも GET です。
HTTP リクエスト
GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
name |
string
必須。この特定のハッシュリストの名前。脅威リストまたはグローバル キャッシュのいずれかです。
|
クエリ パラメータ
| パラメータ |
version |
string (bytes format)
クライアントがすでに持っているハッシュリストのバージョン。クライアントがハッシュリストを初めて取得する場合は、このフィールドを空にする必要があります。それ以外の場合は、クライアントはサーバーから以前に受信したバージョンを提供する必要があります。クライアントはこれらのバイトを操作してはなりません。 v5 の新機能: API の v4 では states と呼ばれていましたが、わかりやすくするために version に名前が変更されました。 Base64 でエンコードされた文字列。
|
sizeConstraints |
object (SizeConstraints)
リストのサイズ制限。省略した場合、制約はありません。制約は、処理能力、帯域幅、ストレージに制限があるすべてのデバイスに推奨されます。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には HashList のインスタンスが含まれます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eGet the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter specifies the hash list to retrieve.\u003c/p\u003e\n"],["\u003cp\u003eProvide the \u003ccode\u003eversion\u003c/code\u003e query parameter to indicate the client's current hash list version or leave it empty for the initial fetch.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, specify the desired hash prefix length using the \u003ccode\u003edesiredHashLength\u003c/code\u003e query parameter and set size constraints with the \u003ccode\u003esizeConstraints\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will contain the requested \u003ccode\u003eHashList\u003c/code\u003e data.\u003c/p\u003e\n"]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"],null,["# Method: hashList.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nGet the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache.\n\nThis is a standard Get method as defined by \u003chttps://google.aip.dev/131\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST be left empty. Otherwise, the client SHOULD supply the version previously received from the server. The client MUST NOT manipulate those bytes. **What's new in V5** : in V4 of the API, this was called `states`; it is now renamed to `version` for clarity. A base64-encoded string. |\n| `sizeConstraints` | `object (`[SizeConstraints](/safe-browsing/reference/rest/v5alpha1/SizeConstraints)`)` The size constraints on the list. If omitted, there are no constraints. Constraints are recommended on all devices with limited processing power, bandwidth, or storage. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [HashList](/safe-browsing/reference/rest/v5alpha1/hashList#HashList)."]]
