Remarketing Audiences: patch

يجب تقديم تفويض.

لتعديل شريحة جمهور حالية لتجديد النشاط التسويقي تدعم هذه الطريقة دلالات التصحيح. اطّلِع على مثال.

الطلب

طلب 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. */ });
}