Memerlukan otorisasi
Mengupload data untuk sumber data kustom. Lihat contoh.
Metode ini mendukung URI /upload dan menerima media yang diupload dengan karakteristik berikut:
- Ukuran file maksimum: 1 GB
- Jenis MIME Media yang diterima:
application/octet-stream
Selain parameter standar, metode ini mendukung parameter yang tercantum dalam tabel parameter.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
accountId |
string |
ID akun yang terkait dengan upload. |
customDataSourceId |
string |
ID sumber data khusus yang mencakup data yang diupload. |
webPropertyId |
string |
String UA properti web yang terkait dengan upload. |
Parameter kueri yang diperlukan | ||
uploadType |
string |
Jenis permintaan upload ke URI /upload.
Nilai yang dapat diterima adalah:
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
Isi permintaan
Jangan menyediakan isi permintaan dengan metode ini.
Tanggapan
Jika berhasil, metode ini menampilkan Resource upload dalam isi respons.
Contoh
Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).
Java
Menggunakan library klien Java.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Data Import Developer Guide for details. */ // This request uploads a file for the authorized user. File file = new File("data.csv"); InputStreamContent mediaContent = new InputStreamContent("application/octet-stream", new FileInputStream(file)); mediaContent.setLength(file.length()); try { analytics.management().uploads().uploadData("123456", "UA-123456-1", "122333444455555", mediaContent).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
Menggunakan library klien PHP.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Data Import Developer Guide for details. */ /** * This request uploads a file to a custom data source. */ try { $analytics->management_uploads->uploadData( '123456', 'UA-123456-1', '122333444455555', array('data' => file_get_contents('example.csv'), 'mimeType' => 'application/octet-stream', 'uploadType' => 'media')); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
Python
Menggunakan library klien Python.
# Note: This code assumes you have an authorized Analytics service object. # See the Data Import Developer Guide for details. # This request uploads a file custom_data.csv to a particular customDataSource. # Note that this example makes use of the MediaFileUpload Object from the # apiclient.http module. from apiclient.http import MediaFileUpload try: media = MediaFileUpload('custom_data.csv', mimetype='application/octet-stream', resumable=False) daily_upload = analytics.management().uploads().uploadData( accountId='123456', webPropertyId='UA-123456-1', customDataSourceId='9876654321', media_body=media).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason))
JavaScript
Menggunakan library klien JavaScript.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Data Import Developer Guide for details. */ /* * This request uploads a file for the authorized user. */ function uploadData(fileData) { const boundary = '-------314159265358979323846'; const delimiter = "\r\n--" + boundary + "\r\n"; const close_delim = "\r\n--" + boundary + "--"; var contentType = 'application/octet-stream' var reader = new FileReader(); reader.readAsBinaryString(fileData); reader.onload = function(e) { var contentType = 'application/octet-stream'; var metadata = { 'title': fileData.name, 'mimeType': contentType }; var base64Data = btoa(reader.result); var multipartRequestBody = delimiter + 'Content-Type: application/json\r\n\r\n' + JSON.stringify(metadata) + delimiter + 'Content-Type: ' + contentType + '\r\n' + 'Content-Transfer-Encoding: base64\r\n' + '\r\n' + base64Data + close_delim; var request = gapi.client.request({ 'path': 'upload/analytics/v3/management/accounts/123456/webproperties/UA-123456-1/customDataSources/ABCDEFG123abcDEF123/uploads', 'method': 'POST', 'params': {'uploadType': 'multipart'}, 'headers': { 'Content-Type': 'multipart/mixed; boundary="' + boundary + '"' }, 'body': multipartRequestBody }); request.execute(function (response) { // Handle the response. }); } }