# Admin Data Transfer API . transfers

## Instance Methods

Retrieves a data transfer request by its resource ID.

Inserts a data transfer request.

Lists the transfers for a customer by source user, destination user, or status.

Retrieves the next page of results.

### Method Details

`get(dataTransferId)`

    Retrieves a data transfer request by its resource ID.

    Args:
      dataTransferId: string, ID of the resource to be retrieved. This is returned in the response from the insert method. (required)

    Returns:
      An object of the form:

        { # The JSON template for a DataTransfer resource.
          "kind": "admin#datatransfer#DataTransfer", # Identifies the resource as a DataTransfer request.
          "requestTime": "A String", # The time at which the data transfer was requested (Read-only).
          "applicationDataTransfers": [ # List of per application data transfer resources. It contains data transfer details of the applications associated with this transfer resource. Note that this list is also used to specify the applications for which data transfer has to be done at the time of the transfer resource creation.
            { # Template to map fields of ApplicationDataTransfer resource.
              "applicationTransferParams": [ # The transfer parameters for the application. These parameters are used to select the data which will get transfered in context of this application.
                { # Template for application transfer parameters.
                  "value": [ # The value of the coressponding transfer parameter. eg: 'PRIVATE' or 'SHARED'
                    "A String",
                  ],
                  "key": "A String", # The type of the transfer parameter. eg: 'PRIVACY_LEVEL'
                },
              ],
              "applicationTransferStatus": "A String", # Current status of transfer for this application. (Read-only)
              "applicationId": "A String", # The application's ID.
            },
          ],
          "newOwnerUserId": "A String", # ID of the user to whom the data is being transfered.
          "oldOwnerUserId": "A String", # ID of the user whose data is being transfered.
          "etag": "A String", # ETag of the resource.
          "overallTransferStatusCode": "A String", # Overall transfer status (Read-only).
          "id": "A String", # The transfer's ID (Read-only).
        }

`insert(body)`

    Inserts a data transfer request.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    { # The JSON template for a DataTransfer resource.
        "kind": "admin#datatransfer#DataTransfer", # Identifies the resource as a DataTransfer request.
        "requestTime": "A String", # The time at which the data transfer was requested (Read-only).
        "applicationDataTransfers": [ # List of per application data transfer resources. It contains data transfer details of the applications associated with this transfer resource. Note that this list is also used to specify the applications for which data transfer has to be done at the time of the transfer resource creation.
          { # Template to map fields of ApplicationDataTransfer resource.
            "applicationTransferParams": [ # The transfer parameters for the application. These parameters are used to select the data which will get transfered in context of this application.
              { # Template for application transfer parameters.
                "value": [ # The value of the coressponding transfer parameter. eg: 'PRIVATE' or 'SHARED'
                  "A String",
                ],
                "key": "A String", # The type of the transfer parameter. eg: 'PRIVACY_LEVEL'
              },
            ],
            "applicationTransferStatus": "A String", # Current status of transfer for this application. (Read-only)
            "applicationId": "A String", # The application's ID.
          },
        ],
        "newOwnerUserId": "A String", # ID of the user to whom the data is being transfered.
        "oldOwnerUserId": "A String", # ID of the user whose data is being transfered.
        "etag": "A String", # ETag of the resource.
        "overallTransferStatusCode": "A String", # Overall transfer status (Read-only).
        "id": "A String", # The transfer's ID (Read-only).
      }

    Returns:
      An object of the form:

        { # The JSON template for a DataTransfer resource.
          "kind": "admin#datatransfer#DataTransfer", # Identifies the resource as a DataTransfer request.
          "requestTime": "A String", # The time at which the data transfer was requested (Read-only).
          "applicationDataTransfers": [ # List of per application data transfer resources. It contains data transfer details of the applications associated with this transfer resource. Note that this list is also used to specify the applications for which data transfer has to be done at the time of the transfer resource creation.
            { # Template to map fields of ApplicationDataTransfer resource.
              "applicationTransferParams": [ # The transfer parameters for the application. These parameters are used to select the data which will get transfered in context of this application.
                { # Template for application transfer parameters.
                  "value": [ # The value of the coressponding transfer parameter. eg: 'PRIVATE' or 'SHARED'
                    "A String",
                  ],
                  "key": "A String", # The type of the transfer parameter. eg: 'PRIVACY_LEVEL'
                },
              ],
              "applicationTransferStatus": "A String", # Current status of transfer for this application. (Read-only)
              "applicationId": "A String", # The application's ID.
            },
          ],
          "newOwnerUserId": "A String", # ID of the user to whom the data is being transfered.
          "oldOwnerUserId": "A String", # ID of the user whose data is being transfered.
          "etag": "A String", # ETag of the resource.
          "overallTransferStatusCode": "A String", # Overall transfer status (Read-only).
          "id": "A String", # The transfer's ID (Read-only).
        }

`list(status=None, oldOwnerUserId=None, pageToken=None, maxResults=None, newOwnerUserId=None, customerId=None)`

    Lists the transfers for a customer by source user, destination user, or status.

    Args:
      status: string, Status of the transfer.
      oldOwnerUserId: string, Source user's profile ID.
      pageToken: string, Token to specify the next page in the list.
      maxResults: integer, Maximum number of results to return. Default is 100.
      newOwnerUserId: string, Destination user's profile ID.
      customerId: string, Immutable ID of the Google Apps account.

    Returns:
      An object of the form:

        { # Template for a collection of DataTransfer resources.
        "nextPageToken": "A String", # Continuation token which will be used to specify next page in list API.
        "kind": "admin#datatransfer#dataTransfersList", # Identifies the resource as a collection of data transfer requests.
        "etag": "A String", # ETag of the resource.
        "dataTransfers": [ # List of data transfer requests.
          { # The JSON template for a DataTransfer resource.
              "kind": "admin#datatransfer#DataTransfer", # Identifies the resource as a DataTransfer request.
              "requestTime": "A String", # The time at which the data transfer was requested (Read-only).
              "applicationDataTransfers": [ # List of per application data transfer resources. It contains data transfer details of the applications associated with this transfer resource. Note that this list is also used to specify the applications for which data transfer has to be done at the time of the transfer resource creation.
                { # Template to map fields of ApplicationDataTransfer resource.
                  "applicationTransferParams": [ # The transfer parameters for the application. These parameters are used to select the data which will get transfered in context of this application.
                    { # Template for application transfer parameters.
                      "value": [ # The value of the coressponding transfer parameter. eg: 'PRIVATE' or 'SHARED'
                        "A String",
                      ],
                      "key": "A String", # The type of the transfer parameter. eg: 'PRIVACY_LEVEL'
                    },
                  ],
                  "applicationTransferStatus": "A String", # Current status of transfer for this application. (Read-only)
                  "applicationId": "A String", # The application's ID.
                },
              ],
              "newOwnerUserId": "A String", # ID of the user to whom the data is being transfered.
              "oldOwnerUserId": "A String", # ID of the user whose data is being transfered.
              "etag": "A String", # ETag of the resource.
              "overallTransferStatusCode": "A String", # Overall transfer status (Read-only).
              "id": "A String", # The transfer's ID (Read-only).
            },
        ],
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.