Reference documentation and code samples for the Google Cloud Storage Transfer V1 Client class HttpData.
An HttpData resource specifies a list of objects on the web to be
transferred over HTTP. The information of the objects to be transferred is
contained in a file referenced by a URL. The first line in the file must be"TsvHttpData-1.0", which specifies the format of the file. Subsequent
lines specify the information of the list of objects, one object per list
entry. Each entry has the following tab-delimited fields:
HTTP URL— The location of the object.
Length— The size of the object in bytes.
MD5— The base64-encoded MD5 hash of the object.
For an example of a valid TSV file, seeTransferring data from
URLs.
When transferring data based on a URL list, keep the following in mind:
When an object located athttp(s)://hostname:port/<URL-path>is
transferred to a data sink, the name of the object at the data sink is<hostname>/<URL-path>.
If the specified size of an object does not match the actual size of the
object fetched, the object is not transferred.
If the specified MD5 does not match the MD5 computed from the transferred
bytes, the object transfer fails.
Ensure that each URL you specify is publicly accessible. For
example, in Cloud Storage you canshare an object publiclyand get a link to it.
Storage Transfer Service obeysrobots.txtrules and requires the source
HTTP server to supportRangerequests and to return aContent-Lengthheader in each response.
ObjectConditionshave no
effect when filtering objects to transfer.
Generated from protobuf messagegoogle.storagetransfer.v1.HttpData
Namespace
Google \ Cloud \ StorageTransfer \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ list_url
string
Required. The URL that points to the file that stores the object list entries. This file must allow public access. The URL is either an HTTP/HTTPS address (e.g.https://example.com/urllist.tsv) or a Cloud Storage path (e.g.gs://my-bucket/urllist.tsv).
getListUrl
Required. The URL that points to the file that stores the object list
entries. This file must allow public access. The URL is either an
HTTP/HTTPS address (e.g.https://example.com/urllist.tsv) or a Cloud
Storage path (e.g.gs://my-bucket/urllist.tsv).
Returns
Type
Description
string
setListUrl
Required. The URL that points to the file that stores the object list
entries. This file must allow public access. The URL is either an
HTTP/HTTPS address (e.g.https://example.com/urllist.tsv) or a Cloud
Storage path (e.g.gs://my-bucket/urllist.tsv).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Cloud Storage Transfer V1 Client - Class HttpData (2.2.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.2.1 (latest)](/php/docs/reference/cloud-storage-transfer/latest/V1.HttpData)\n- [2.2.0](/php/docs/reference/cloud-storage-transfer/2.2.0/V1.HttpData)\n- [2.1.1](/php/docs/reference/cloud-storage-transfer/2.1.1/V1.HttpData)\n- [2.0.2](/php/docs/reference/cloud-storage-transfer/2.0.2/V1.HttpData)\n- [1.5.0](/php/docs/reference/cloud-storage-transfer/1.5.0/V1.HttpData)\n- [1.4.5](/php/docs/reference/cloud-storage-transfer/1.4.5/V1.HttpData)\n- [1.3.1](/php/docs/reference/cloud-storage-transfer/1.3.1/V1.HttpData)\n- [1.2.0](/php/docs/reference/cloud-storage-transfer/1.2.0/V1.HttpData)\n- [1.1.1](/php/docs/reference/cloud-storage-transfer/1.1.1/V1.HttpData)\n- [1.0.6](/php/docs/reference/cloud-storage-transfer/1.0.6/V1.HttpData) \nReference documentation and code samples for the Google Cloud Storage Transfer V1 Client class HttpData.\n\nAn HttpData resource specifies a list of objects on the web to be\ntransferred over HTTP. The information of the objects to be transferred is\ncontained in a file referenced by a URL. The first line in the file must be\n`\"TsvHttpData-1.0\"`, which specifies the format of the file. Subsequent\nlines specify the information of the list of objects, one object per list\nentry. Each entry has the following tab-delimited fields:\n\n- **HTTP URL** --- The location of the object.\n\n\u003c!-- --\u003e\n\n- **Length** --- The size of the object in bytes.\n - **MD5** --- The base64-encoded MD5 hash of the object. For an example of a valid TSV file, see [Transferring data from\n URLs](https://cloud.google.com/storage-transfer/docs/create-url-list). When transferring data based on a URL list, keep the following in mind:\n- When an object located at `http(s)://hostname:port/\u003cURL-path\u003e` is transferred to a data sink, the name of the object at the data sink is `\u003chostname\u003e/\u003cURL-path\u003e`.\n- If the specified size of an object does not match the actual size of the object fetched, the object is not transferred.\n- If the specified MD5 does not match the MD5 computed from the transferred bytes, the object transfer fails.\n- Ensure that each URL you specify is publicly accessible. For example, in Cloud Storage you can [share an object publicly](/storage/docs/cloud-console#_sharingdata) and get a link to it.\n- Storage Transfer Service obeys `robots.txt` rules and requires the source HTTP server to support `Range` requests and to return a `Content-Length` header in each response.\n- [ObjectConditions](/php/docs/reference/cloud-storage-transfer/latest/V1.ObjectConditions) have no effect when filtering objects to transfer.\n\nGenerated from protobuf message `google.storagetransfer.v1.HttpData`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ StorageTransfer \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getListUrl\n\nRequired. The URL that points to the file that stores the object list\nentries. This file must allow public access. The URL is either an\nHTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud\nStorage path (e.g. `gs://my-bucket/urllist.tsv`).\n\n### setListUrl\n\nRequired. The URL that points to the file that stores the object list\nentries. This file must allow public access. The URL is either an\nHTTP/HTTPS address (e.g. `https://example.com/urllist.tsv`) or a Cloud\nStorage path (e.g. `gs://my-bucket/urllist.tsv`)."]]