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 تسوّق

ServiceLevel

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

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

الطُرق

acknowledgeUserDataCollection

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

create

 تنشئ هذه الطريقة موقعًا على "إحصاءات Google" بالموقع الجغرافي والسمات المحدّدة.

delete

 يضع علامة على السمة المستهدَفة على أنّها محذوفة بشكلٍ مبدئي (أي "نُقلت إلى المهملات") ويعرضها.

get

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

getDataRetentionSettings

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

list

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

patch

 تعديل موقع

runAccessReport

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

updateDataRetentionSettings

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