Aktualisiert ein vorhandenes Zielvorhaben. Probieren Sie es gleich aus oder sehen Sie sich ein Beispiel an.
Bei dieser Methode werden zusätzlich zu den Standardparametern die in der Parametertabelle aufgeführten Parameter unterstützt.
Anfragen
HTTP-Anfrage
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
accountId |
string |
Konto-ID, um das Zielvorhaben zu aktualisieren. |
goalId |
string |
Index des Ziels, das aktualisiert werden soll. |
profileId |
string |
ID der Datenansicht (Profil) aus, um das Zielvorhaben zu aktualisieren. |
webPropertyId |
string |
Web-Property-ID, um das Zielvorhaben zu aktualisieren. |
Autorisierung
Für diese Anfrage ist eine Autorisierung im folgenden Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung
Bereich |
---|
https://www.googleapis.com/auth/analytics.edit |
Anfragetext
Geben Sie im Anfragetext eine Ressource vom Typ management.goal an.
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ "management.goal" im Antworttext zurückgegeben.
Beispiele
Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.
Java
Verwendet die Java-Clientbibliothek.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Goals Developer Guide for details. */ /* * This request updates 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().update("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
Verwendet die PHP-Clientbibliothek.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Goal Developer Guide for details. */ /** * This request updates an existing Goal. */ // Construct the body of the request. $goal = new Google_Service_Analytics_Goal(); $goal->setActive(False); $goal->setName('My Goal'); $goal->setType('VISIT_TIME_ON_SITE'); // Construct the time on site details. $details = new Google_Service_Analytics_GoalVisitTimeOnSiteDetails(); $details->setComparisonType('GREATER_THAN'); $details->setComparisonValue(300.0); //Set the time on site details. $goal->setVisitTimeOnSiteDetails($details); try { $analytics->management_goals->update('123456', 'UA-123456-1', '756321', '2', $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
Verwendet die Python-Clientbibliothek.
# Note: This code assumes you have an authorized Analytics service object. # See the Goals Developer Guide for details. # This request updates an existing goal. try: analytics.management().goals().update( 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': 400 } } ).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
Es wird die JavaScript-Clientbibliothek verwendet.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Goals Developer Guide for details. */ /* * This request updates an existing goal. */ function updateGoal() { var request = gapi.client.analytics.management.goals.update( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'profileId': '7654321', 'goalId': '5', 'resource': { 'active': true, 'name': 'My Goal', 'type': 'VISIT_TIME_ON_SITE', 'visitTimeOnSiteDetails': { 'comparissonType': 'GREATER_THAN', 'comparisonValue': 300 } } }); request.execute(function (response) { // Handle the response. }); }
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen. Probieren Sie alternativ den eigenständigen Explorer aus.