REST Resource: properties
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: Property
Paire clé-valeur associée à un fichier public ou privé pour une application.
Les limites suivantes s'appliquent aux propriétés de fichier:
- 100 propriétés au maximum par fichier
- 30 propriétés privées maximum par application
- 30 propriétés publiques maximum
- Limite de taille maximale de 124 octets pour la chaîne (clé + valeur) encodée en UTF-8 pour une seule propriété
Certaines méthodes de ressources (telles que properties.update
) nécessitent un propertyKey
. Utilisez la méthode properties.list
pour récupérer la clé d'une propriété.
Représentation JSON |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
Champs |
selfLink |
string
Uniquement en sortie. Lien vers cette propriété.
|
value |
string
Valeur de cette propriété.
|
visibility |
string
Visibilité de cette propriété. Les valeurs autorisées sont PRIVATE (PRIVÉ, par défaut) et PUBLIC. Les propriétés privées ne peuvent être récupérées qu'à l'aide d'une requête authentifiée. Une requête authentifiée utilise un jeton d'accès obtenu avec un ID client OAuth 2. Vous ne pouvez pas utiliser une clé API pour récupérer des propriétés privées.
|
kind |
string
Uniquement en sortie. Cette valeur est toujours drive#property .
|
etag |
string
Uniquement en sortie. ETag de la propriété.
|
key |
string
Clé de cette propriété.
|
Méthodes |
|
Supprime une propriété. |
|
Récupère une propriété par sa clé. |
|
Ajoute une propriété à un fichier ou la met à jour si elle existe déjà. |
|
Répertorie les propriétés d'un fichier. |
|
Met à jour une propriété. |
|
Met à jour une propriété. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]