Transférer les données
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour utiliser l'API Data Transfer, vous devez définir un transfert, puis l'initier à l'aide de la méthode insert
. Le transfert est défini en termes d'une ou de plusieurs applications dont les données seront transférées et peut inclure des paramètres spécifiques à l'application.
Voici un résumé général du processus de transfert:
- Déterminez les applications pour lesquelles vous souhaitez transférer des données.
- Définissez une ressource
DataTransfer
qui spécifie les utilisateurs source et de destination, ainsi que les applications pour lesquelles transférer des données.
- Lancez le transfert à l'aide de la méthode
insert()
.
Par exemple, le corps de la requête JSON suivant transfère un agenda de l'utilisateur source (SOURCE_USER_ID
) à l'utilisateur de destination (DESTINATION_USER_ID
). Vous pouvez récupérer les ID utilisateur de chaque propriétaire en appelant la méthode user.get()
de l'API Directory et en fournissant son adresse e-mail ou son alias.
{
"oldOwnerUserId": "SOURCE_USER_ID",
"newOwnerUserId": "DESTINATION_USER_ID",
"applicationDataTransfers": [
{
"applicationId": "435070579839",
"applicationTransferParams": [
{
"key": "RELEASE_RESOURCES",
"value": [
"TRUE"
]
}
]
}
]
}
L'API Data Transfer inclut des méthodes et des ressources supplémentaires pour vous aider à créer et à gérer des transferts, ce qui vous permet d'effectuer les opérations suivantes:
- Liste des applications disponibles pour le transfert de données.
- Obtenez des informations sur l'application par ID d'application.
- Listez les transferts par utilisateur source, utilisateur de destination ou état.
- Obtenir une demande de transfert par ID de ressource.
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/03/25 (UTC).
[null,null,["Dernière mise à jour le 2025/03/25 (UTC)."],[],[],null,["# Transfer data\n\nTo use the Data Transfer API, you define a transfer and then initiate\nit using the `insert` method. The transfer is defined in terms of one or more\napplications whose data will be transferred, and can include\n[application-specific parameters](/workspace/admin/data-transfer/v1/parameters).\n\nThe following is a high-level summary of the transfer process:\n\n1. Determine the applications for which you want to transfer data.\n2. Define a [`DataTransfer` resource](/workspace/admin/data-transfer/reference/rest/v1/transfers) that specifies the source and destination users and the applications for which to transfer data.\n3. Initiate the transfer by using the [`insert()` method](/workspace/admin/data-transfer/reference/rest/v1/transfers/insert).\n\nFor example, the following JSON request body transfers a calendar from\nthe source user (\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e) to the destination user\n(\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e). You can retrieve the user IDs for\neach owner by calling the\n[`user.get()` method](/workspace/admin/directory/reference/rest/v1/users/get)\nof the Directory API and providing their email address or email alias. \n\n {\n \"oldOwnerUserId\": \"\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e\",\n \"newOwnerUserId\": \"\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e\",\n \"applicationDataTransfers\": [\n {\n \"applicationId\": \"435070579839\",\n \"applicationTransferParams\": [\n {\n \"key\": \"RELEASE_RESOURCES\",\n \"value\": [\n \"TRUE\"\n ]\n }\n ]\n }\n ]\n }\n\nRelated topics\n--------------\n\nThe Data Transfer API includes additional methods and resources to\nhelp you construct and administer transfers, allowing you to do things like\nthe following:\n\n- [List](/workspace/admin/data-transfer/v1/reference/applications/list) applications available for data transfer.\n- [Get](/workspace/admin/data-transfer/v1/reference/applications/get) application information by application ID.\n- [List](/workspace/admin/data-transfer/v1/reference/transfers/list) transfers by source user, destination user, or status.\n- [Get](/workspace/admin/data-transfer/v1/reference/transfers/get) a transfer request by resource ID."]]