נדרשת הרשאה
עדכון קהל קיים לרימרקטינג. השיטה הזו תומכת בסמנטיקה של תיקונים. להצגת דוגמה
בקשה
בקשת HTTP
PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
פרמטרים
שם הפרמטר | ערך | תיאור |
---|---|---|
פרמטרים של נתיב | ||
accountId |
string |
מספר החשבון של הקהל לרימרקטינג שיש לעדכן. |
remarketingAudienceId |
string |
המזהה של קהל הרימרקטינג שיש לעדכן. |
webPropertyId |
string |
מזהה נכס האינטרנט של הקהל לרימרקטינג שיש לעדכן. |
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא (מידע נוסף על אימות והרשאה).
היקף |
---|
https://www.googleapis.com/auth/analytics.edit |
גוף הבקשה
בגוף הבקשה, מספקים את החלקים הרלוונטיים של משאב 'קהלים לרימרקטינג', בהתאם לכללי הסמנטיקה של התיקונים.
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה משאב של קהלים לרימרקטינג בגוף התגובה.
דוגמאות
הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).
Java
משתמש בספריית הלקוח של Java.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Remarketing Audiences Developer Guide for details. */ /* * This request patches 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("Patch Simple Audience"); audience.setLinkedViews(Arrays.asList(viewId)); audience.setLinkedAdAccounts(Arrays.asList(linkedAdAccount)); audience.setAudienceType("SIMPLE"); audience.setAudienceDefinition(audienceDefinition); try { analytics .management() .remarketingAudience() .patch(accountId, propertyId, remarketingAudienceId, audience) .execute(); } catch (GoogleJsonResponseException e) { System.err.println( "There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
משתמש בספריית הלקוח של PHP.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Remarketing Audiences Developer Guide for details. */ /* * This request patches 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("Patch Simple Audience"); $audience->setLinkedViews(Arrays.asList(viewId)); $audience->setLinkedAdAccounts(Arrays.asList($linkedAdAccount)); $audience->setAudienceType("SIMPLE"); $audience->setAudienceDefinition($audienceDefinition); try { $analytics->management_remarketingAudience->patch($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 patches an existing Remarketing Audience. try: analytics.management().remarketingAudience().patch( accountId=accountId, webPropertyId=propertyId, remarketingAudienceId=remarketingAudienceId, body={ 'name': 'Patch 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
נעשה שימוש בספריית הלקוח של JavaScript.
/** * Note: This code assumes you have an authorized Analytics client object. * See the Unsampled Reports Developer Guide for details. */ /** * This request patches an existing Remarketing Audience. */ function patchRemarketingAudience(accountId, propertyId, audienceId, viewId) { let request = gapi.client.analytics.management.remarketingAudience.patch( { 'accountId': accountId, 'webPropertyId': propertyId, 'remarketingAudienceId': audienceId 'resource': { 'name': 'Patch 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. */ }); }