需要授權
更新現有的再行銷目標對象。 參閱範例。
要求
HTTP 要求
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
accountId |
string |
要更新的再行銷目標對象的帳戶 ID。 |
remarketingAudienceId |
string |
要更新的再行銷目標對象 ID。 |
webPropertyId |
string |
要更新的再行銷目標對象網站資源 ID。 |
授權
這項要求需要下列範圍的授權 (進一步瞭解驗證和授權)。
範圍 |
---|
https://www.googleapis.com/auth/analytics.edit |
要求主體
在請求主體中,提供 再行銷目標對象資源。
回應
成功的話,這個方法會在回應主體中傳回 再行銷目標對象資源。
範例
注意:這個方法適用的程式語言眾多,我們只在此提供部分程式碼範例,完整的支援語言清單請參閱用戶端程式庫頁面。
Java
使用 Java 用戶端程式庫。
/* * This request updates an existing Remarketing Audience. */ // Create the LinkedForeignAccount object. LinkedForeignAccount linkedAdAccount = new LinkedForeignAccount(); linkedAdAccount.setType("ADWORDS_LINKS"); linkedAdAccount.setAccountId(linkedAccountId); // Create the IncludeConditions object. IncludeConditions includeConditions = new IncludeConditions(); includeConditions.setIsSmartList(false); includeConditions.setDaysToLookBack(7); includeConditions.setMembershipDurationDays(30); includeConditions.setSegment("users::condition::ga:browser==Chrome"); // Create the AudienceDefinition object. AudienceDefinition audienceDefinition = new AudienceDefinition(); audienceDefinition.setIncludeConditions(includeConditions); // Create the RemarketingAudience object. RemarketingAudience audience = new RemarketingAudience(); audience.setName("Update Simple Audience"); audience.setLinkedViews(Arrays.asList(viewId)); audience.setLinkedAdAccounts(Arrays.asList(linkedAdAccount)); audience.setAudienceType("SIMPLE"); audience.setAudienceDefinition(audienceDefinition); try { analytics .management() .remarketingAudience() .update(accountId, propertyId, remarketingAudienceId, audience) .execute(); } catch (GoogleJsonResponseException e) { System.err.println( "There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
使用 PHP 用戶端程式庫。
/* * This request updates an existing Remarketing Audience. */ // Create the LinkedForeignAccount object. Google_Service_Analytics_LinkedForeignAccount $linkedAdAccount = new Google_Service_Analytics_LinkedForeignAccount(); $linkedAdAccount->setType("ADWORDS_LINKS"); $linkedAdAccount->setAccountId(linkedAccountId); // Create the IncludeConditions object. Google_Service_Analytics_IncludeConditions $includeConditions = new Google_Service_Analytics_IncludeConditions(); $includeConditions->setIsSmartList(false); $includeConditions->setDaysToLookBack(7); $includeConditions->setMembershipDurationDays(30); $includeConditions->setSegment("users::condition::ga:browser==Chrome"); // Create the AudienceDefinition object. Google_Service_Analytics_RemarketingAudienceAudienceDefinition $audienceDefinition = new Google_Service_Analytics_RemarketingAudienceAudienceDefinition(); $audienceDefinition->setIncludeConditions($includeConditions); // Create the RemarketingAudience object. Google_Service_Analytics_RemarketingAudience $audience = new Google_Service_Analytics_RemarketingAudience(); $audience->setName("Update Simple Audience"); $audience->setLinkedViews(Arrays.asList(viewId)); $audience->setLinkedAdAccounts(Arrays.asList($linkedAdAccount)); $audience->setAudienceType("SIMPLE"); $audience->setAudienceDefinition($audienceDefinition); try { $analytics->management_remarketingAudience->update($accountId, $propertyId, remarketingAudienceId, $audience); } 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
使用 Python 用戶端程式庫。
# Note: This code assumes you have an authorized Analytics service object. # See the Remarketing Audiences Developer Guide for details. # This request updates an existing Remarketing Audience. try: analytics.management().remarketingAudience().update( accountId=accountId, webPropertyId=propertyId, remarketingAudienceId=remarketingAudienceId, body={ 'name': 'Update Simple Audience', 'linkedViews': [viewId], 'linkedAdAccounts': [{ 'type': 'ADWORDS_LINKS', 'linkedAccountId': linkedAccountId }], 'audienceType': 'SIMPLE', 'audienceDefinition': { 'includeConditions': { 'isSmartList': False, 'daysToLookBack': 7, 'membershipDurationDays': 30, 'segment': 'users::condition::ga:browser==Chrome' } } } ).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
/** * Note: This code assumes you have an authorized Analytics client object. * See the Unsampled Reports Developer Guide for details. */ /** * This request updates an existing Remarketing Audience. */ function updateRemarketingAudience(accountId, propertyId, viewId, audienceId) { let request = gapi.client.analytics.management.remarketingAudience.update( { 'accountId': accountId, 'webPropertyId': propertyId, 'remarketingAudienceId': audienceId 'resource': { 'name': 'Update Simple Audience', 'linkedViews': [viewId], 'linkedAdAccounts': [{ 'type': 'ADWORDS_LINKS', 'linkedAccountId': '202-867-5309' }], 'audienceType': 'SIMPLE', 'audienceDefinition': { 'includeConditions': { 'isSmartList': False, 'daysToLookBack': 7, 'membershipDurationDays': 30, 'segment': 'users::condition::ga:browser==Chrome' } } } }); request.execute(function (response) { /* handle the response */ }); }