ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را در 1 ژوئیه 2023 متوقف کردند . دارایی‌های UA 360 پردازش داده‌ها را در تاریخ 1 ژوئیه 2024 متوقف خواهند کرد و برخی از ویژگی‌های UA 360 قبل از آن منسوخ خواهند شد ، زیرا ما به Google Analytics 4 منتقل می‌شویم . از Admin API برای تهیه و مدیریت ویژگی های GA4 استفاده کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Web Properties: insert

نیاز به مجوز دارد

یک ویژگی جدید ایجاد می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.

درخواست

درخواست HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties

مولفه های

نام پارامتر	ارزش	شرح
پارامترهای مسیر
`accountId`	`string`	شناسه حساب برای ایجاد ویژگی وب.

مجوز

این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
`https://www.googleapis.com/auth/analytics.edit`

درخواست بدن

در بدنه درخواست، یک منبع management.webproperty ارائه کنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع management.webproperty را در بدنه پاسخ باز می گرداند.

مثال ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه سرویس گیرنده جاوا استفاده می کند.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Web Property Developer Guide for details.
 */

/*
 * This request creates a new property.
 */

// Construct the body of the request.
Webproperty body = new Webproperty();
body.setWebsiteUrl("http://www.examplepetstore.com");
body.setName("Example Store");

try {
  analytics.management().webproperties().insert("123456", body).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 Web Property Developer Guide for details.
 */

/**
 * This request creates a new property.
 */
try {
  $property = new Google_Service_Analytics_Webproperty();
  $property->setName('Example Store');
  $analytics->management_webproperties->insert('123456', $property);
} 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();
}

پایتون

از کتابخانه کلاینت پایتون استفاده می کند.

# Note: This code assumes you have an authorized Analytics service object.
# See the Web Property Developer Guide for details.

# This request creates a new property.
try:
  analytics.management().webproperties().insert(
      accountId='123456',
      body={
          'websiteUrl': 'http://www.examplepetstore.com',
          'name': 'Example Store'
      }
  ).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))

جاوا اسکریپت

از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Web Property Developer Guide for details.
 */

/*
 * This request creates a new property.
 */
function insertProperty() {
  var request = gapi.client.analytics.management.webproperties.insert(
    {
      'accountId': '123456',
      'resource': {
        'websiteUrl': 'http://www.examplepetstore.com',
        'name': 'Example Store'
      }
    });
  request.execute(function (response) { // Handle the response. });
}

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.