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" بالموقع الجغرافي والسمات المحدّدة.

createRollupProperty

 إنشاء موقع بيانات مجمّعة وجميع روابط مصادر موقع البيانات المجمّعة

delete

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

get

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

getAttributionSettings

 البحث عن عنصر فردي من AttributionSettings

getDataRetentionSettings

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

getGoogleSignalsSettings

 ابحث عن إعدادات "إشارات Google" لموقع.

getReportingIdentitySettings

 تعرِض هذه السمة إعدادات المعلومات التعريفية في التقارير لهذا الموقع.

getUserProvidedDataSettings

 تبحث هذه الطريقة عن الإعدادات المتعلّقة بالبيانات المقدَّمة من المستخدِم لموقع.

list

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

patch

 تعديل موقع

provisionSubproperty

 أنشئ موقعًا فرعيًا وفلتر أحداث موقع فرعي ينطبق على الموقع الفرعي الذي تم إنشاؤه.

runAccessReport

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

submitUserDeletion

 يرسل طلبًا بحذف مستخدم من موقع.

updateAttributionSettings

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

updateDataRetentionSettings

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

updateGoogleSignalsSettings

 تعدّل هذه الطريقة إعدادات "إشارات Google" لأحد المواقع.

updateReportingIdentitySettings

 تعدّل هذه السمة إعدادات المعلومات التعريفية في التقارير لهذا الموقع.