REST Resource: properties

المرجع: الموقع

رسالة مورد تمثّل موقعًا على "إحصاءات Google".

تمثيل JSON 
{
  "name": string,
  "propertyType": enum (PropertyType),
  "createTime": string,
  "updateTime": string,
  "parent": string,
  "displayName": string,
  "industryCategory": enum (IndustryCategory),
  "timeZone": string,
  "currencyCode": string,
  "serviceLevel": enum (ServiceLevel),
  "deleteTime": string,
  "expireTime": string,
  "account": string
}
الحقول
name

string

النتائج فقط. اسم المورد الخاص بهذه السمة التنسيق: properties/{property_id}، على سبيل المثال: "properties/1000"
propertyType

enum (PropertyType)

غير قابل للتغيير نوع الموقع لمصدر الموقع هذا. عند إنشاء موقع، إذا كان النوع هو "PROPERTY_TYPE_UNSPECIFIED"، سيتم تضمين "ORDINARY_PROPERTY" ضمن القيمة الضمنية.
createTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء الكيان في الأصل

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه آخر تعديل لحقول الحمولة للكيان

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
parent

string

غير قابل للتغيير اسم المورد للعنصر الرئيسي المنطقي لهذا الموقع

ملاحظة: يمكن استخدام واجهة مستخدم نقل المواقع لتغيير العنصر الرئيسي. التنسيق: accounts/{account}، properties/{property}. مثال: "accounts/100"، "properties/101"
displayName

string

مطلوب. الاسم المعروض لهذا الموقع والذي يمكن لشخص عادي قراءته.

الحد الأقصى المسموح به لطول الاسم المعروض هو 100 وحدة ترميز UTF-16.
industryCategory

enum (IndustryCategory)

المجال المرتبط بهذا الموقع الإلكتروني. مثال: AUTOMOTIVE، FOOD_AND_DRINK
timeZone

string

مطلوب. المنطقة الزمنية لإعداد التقارير، المستخدَمة كحدّ اليوم للتقارير، بغض النظر عن مصدر البيانات إذا كانت المنطقة الزمنية تستخدِم التوقيت الصيفي، ستتكيّف "إحصاءات Google" مع التغييرات تلقائيًا.

ملاحظة: لا يؤثّر تغيير المنطقة الزمنية إلّا في البيانات الجديدة، ولا يسري بأثرٍ رجعي.

التنسيق: https://www.iana.org/time-zones مثال: "America/Los_Angeles"
currencyCode

string

نوع العملة المستخدَمة في التقارير التي تتضمّن قيمًا نقدية.

التنسيق: https://en.wikipedia.org/wiki/ISO_4217. الأمثلة: "USD" و"EUR" و"JPY"
serviceLevel

enum (ServiceLevel)

النتائج فقط. مستوى خدمة "إحصاءات Google" الذي ينطبق على هذا الموقع.
deleteTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه وضع هذا الموقع في المهملات، في حال ضبطه إذا لم يتم ضبطها، هذا يعني أنّ هذا الموقع ليس حاليًا في المهملات.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
expireTime

string (Timestamp format)

النتائج فقط. في حال ضبطها، هي الوقت الذي سيتم فيه حذف هذه السمة المُهمَلة نهائيًا. في حال عدم ضبطها، يعني ذلك أنّ هذا الموقع ليس حاليًا في المهملات وليس من المخطّط حذفه.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
account

string

غير قابل للتغيير اسم مورد الحساب الرئيسي بالتنسيق: accounts/{account_id} مثال: "accounts/123"

PropertyType

أنواع موارد Property

عمليات التعداد
PROPERTY_TYPE_UNSPECIFIED نوع خاصية غير معروف أو غير محدّد
PROPERTY_TYPE_ORDINARY موقع عادي على "إحصاءات Google"
PROPERTY_TYPE_SUBPROPERTY الموقع الفرعي على "إحصاءات Google"
PROPERTY_TYPE_ROLLUP موقع البيانات المجمَّعة في "إحصاءات Google"

IndustryCategory

الفئة التي تم اختيارها لهذا الموقع، وتُستخدَم لقياس الأداء في المجال

عمليات التعداد
INDUSTRY_CATEGORY_UNSPECIFIED فئة المجال غير محدّدة
AUTOMOTIVE سيارات
BUSINESS_AND_INDUSTRIAL_MARKETS أسواق تجارية وصناعية
FINANCE شؤون مالية
HEALTHCARE الرعاية الصحية
TECHNOLOGY تكنولوجيا
TRAVEL سفر
OTHER غير ذلك
ARTS_AND_ENTERTAINMENT فنون وترفيه
BEAUTY_AND_FITNESS جمال ولياقة بدنية
BOOKS_AND_LITERATURE كتب وآداب
FOOD_AND_DRINK مأكولات ومشروبات
GAMES الألعاب
HOBBIES_AND_LEISURE هوايات وتسلية
HOME_AND_GARDEN المنازل والحدائق
INTERNET_AND_TELECOM إنترنت واتصالات
LAW_AND_GOVERNMENT قوانين وحكومات
NEWS أخبار
ONLINE_COMMUNITIES مجتمعات الإنترنت
PEOPLE_AND_SOCIETY أشخاص ومجتمع
PETS_AND_ANIMALS حيوانات أليفة وحيوانات أخرى
REAL_ESTATE العقارات
REFERENCE مراجع
SCIENCE علوم
SPORTS رياضة
JOBS_AND_EDUCATION وظائف وتعليم
SHOPPING Shopping

ServiceLevel

مستويات الخدمة المختلفة لخدمة "إحصاءات Google"

عمليات التعداد
SERVICE_LEVEL_UNSPECIFIED لم يتم تحديد مستوى الخدمة أو هو غير صالح.
GOOGLE_ANALYTICS_STANDARD الإصدار العادي من "إحصاءات Google"
GOOGLE_ANALYTICS_360 الإصدار المدفوع والمميّز من "إحصاءات Google".

الطُرق

acknowledgeUserDataCollection

 يقرّ المستخدمون بأحكام جمع بيانات المستخدمين للموقع المحدّد.

create

 لإنشاء موقع على "إحصاءات Google" باستخدام الموقع الجغرافي والسمات المحدّدة

delete

 تضع هذه الوظيفة علامة على "الموقع المستهدَف" على أنّه تم حذفه مؤقتًا (أي "مُرسَل إلى المهملات") وتُعيده.

get

 ابحث عن موقع واحد على "إحصاءات Google".

getDataRetentionSettings

 تعرِض هذه الدالة إعدادات الاحتفاظ ببيانات العناصر الفردية لهذا الموقع.

list

 تعرِض هذه الدالة المواقع الفرعية ضمن الحساب الرئيسي المحدّد.

patch

 تعديل موقع

runAccessReport

 تعرِض هذه الدالة تقريرًا مخصّصًا لسجلّات الوصول إلى البيانات.

updateDataRetentionSettings

 تعديل إعدادات الاحتفاظ بالبيانات الفردية لهذا الموقع