Memerlukan otorisasi
Memperbarui sasaran yang ada. Metode ini mendukung semantik patch. Coba sekarang atau lihat contohnya.
Selain parameter standar, metode ini mendukung parameter yang tercantum dalam tabel parameter.
Permintaan
Permintaan HTTP
PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
accountId |
string |
ID akun untuk memperbarui sasaran. |
goalId |
string |
Indeks sasaran yang akan diperbarui. |
profileId |
string |
ID Tampilan (Profil) untuk memperbarui sasaran. |
webPropertyId |
string |
ID properti web untuk memperbarui sasaran. |
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/analytics.edit |
Isi permintaan
Dalam isi permintaan, sediakan bagian resource management.goal yang relevan, sesuai dengan aturan semantik patch.
Respons
Jika berhasil, metode ini akan menampilkan resource management.goal 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 Goals Developer Guide for details. */ /* * This request patches an existing Goal. */ // Construct the body of the request. Goal body = new Goal(); body.setActive(false); body.setName("My Goal"); body.setType("VISIT_TIME_ON_SITE"); // Construct the time on site details. VisitTimeOnSiteDetails details = new VisitTimeOnSiteDetails(); details.setComparisonType("GREATER_THAN"); details.setComparisonValue((long) 500.0); // Set the time on site details. body.setVisitTimeOnSiteDetails(details); try { analytics.management().goals().patch("123456", "UA-123456-1", "7654321", "1", body).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 Goal Developer Guide for details. */ /** * This request patches an existing Goal. */ // Construct the time on site details. $details = new Google_Service_Analytics_GoalVisitTimeOnSiteDetails(); $details->setComparisonType('GREATER_THAN'); $details->setComparisonValue(300.0); try { // Get an existing goal. $goal = $analytics->management_goals->get('123456', 'UA-123456-1', '756321', '2'); $goal->setVisitTimeOnSiteDetails($details); // Call the patch function. $analytics->management_goals->patch('123456', 'UA-123456-1', '756321', '5', $goal); } 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 Goal Developer Guide for details. # This request patches an existing goal. try: analytics.management().goals().patch( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', goalId='2', body={ 'active': False, 'name': 'My Goal', 'type': 'VISIT_TIME_ON_SITE', 'visitTimeOnSiteDetails': { 'comparisonType': 'GREATER_THAN', 'comparisonValue': 600 } } ).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 Goals Developer Guide for details. */ /* * This request patches an existing goal. */ function patchGoal() { var request = gapi.client.analytics.management.goals.patch( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'profileId': '7654321', 'goalId': '5', 'resource': { 'id': '2', 'active': true, 'name': 'My Goal', 'type': 'VISIT_TIME_ON_SITE', 'visitTimeOnSiteDetails': { 'comparissonType': 'GREATER_THAN', 'comparisonValue': 300 } } }); request.execute(function (response) { // Handle the response. }); }
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons. Atau, coba Explorer mandiri.