REST Resource: properties
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: Property
ファイルに関連付けられた Key-Value ペア。アプリに対して公開または非公開です。
ファイル プロパティには次の上限が適用されます。
- 1 ファイルあたりの宿泊施設の最大数: 100
- アプリごとに最大 30 個のプライベート プロパティ
- 最大 30 個の公開プロパティ
- 1 つのプロパティの UTF-8 エンコードの(キー + 値)文字列の最大サイズの上限は 124 バイト
一部のリソース メソッド(properties.update
など)では propertyKey
が必要です。properties.list
メソッドを使用して、プロパティのキーを取得します。
JSON 表現 |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
フィールド |
selfLink |
string
出力専用。この宿泊施設へのリンク。
|
value |
string
このプロパティの値。
|
visibility |
string
このプロパティの公開設定。指定できる値は PRIVATE(デフォルト)と PUBLIC です。非公開プロパティは、認証済みリクエストを使用してのみ取得できます。認証済みリクエストでは、OAuth 2 クライアント ID で取得したアクセス トークンを使用します。API キーを使用してプライベート プロパティを取得することはできません。
|
kind |
string
出力専用。これは常に drive#property です。
|
etag |
string
出力専用。プロパティの ETag。
|
key |
string
このプロパティのキー。
|
メソッド |
|
プロパティを削除します。 |
|
キーでプロパティを取得します。 |
|
ファイルにプロパティを追加します。プロパティがすでに存在する場合は、更新します。 |
|
ファイルのプロパティを一覧表示します。 |
|
プロパティを更新します。 |
|
プロパティを更新します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# REST Resource: properties\n\n- [Resource: Property](#Property)\n - [JSON representation](#Property.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Property\n------------------\n\nA key-value pair attached to a file that is either public or private to an application.\n\nThe following limits apply to file properties:\n\n- Maximum of 100 properties total per file\n- Maximum of 30 private properties per app\n- Maximum of 30 public properties\n- Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property\n\nSome resource methods (such as `properties.update`) require a `propertyKey`. Use the `properties.list` method to retrieve the key for a property.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"selfLink\": string, \"value\": string, \"visibility\": string, \"kind\": string, \"etag\": string, \"key\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `selfLink` | `string` Output only. The link back to this property. |\n| `value` | `string` The value of this property. |\n| `visibility` | `string` The visibility of this property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties. |\n| `kind` | `string` Output only. This is always `drive#property`. |\n| `etag` | `string` Output only. ETag of the property. |\n| `key` | `string` The key of this property. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|----------------------------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v2/properties/delete) | Deletes a property. |\n| ### [get](/workspace/drive/api/reference/rest/v2/properties/get) | Gets a property by its key. |\n| ### [insert](/workspace/drive/api/reference/rest/v2/properties/insert) | Adds a property to a file, or updates it if it already exists. |\n| ### [list](/workspace/drive/api/reference/rest/v2/properties/list) | Lists a file's properties. |\n| ### [patch](/workspace/drive/api/reference/rest/v2/properties/patch) | Updates a property. |\n| ### [update](/workspace/drive/api/reference/rest/v2/properties/update) | Updates a property. |"]]