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

createConnectedSiteTag

 تُنشئ علامة موقع إلكتروني متّصلة لموقع على Universal Analytics.

createRollupProperty

 أنشئ موقع بيانات مجمّعة وجميع الروابط المصدر لموقع البيانات المجمّعة.

delete

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

deleteConnectedSiteTag

 لحذف علامة موقع إلكتروني مرتبطة لموقع على Universal Analytics

fetchAutomatedGa4ConfigurationOptOut

 تُستخدَم هذه السمة لجلب حالة إيقاف عملية إعداد "إحصاءات Google‏ 4" الآلي لموقع على Universal Analytics.

fetchConnectedGa4Property

 استنادًا إلى موقع محدّد على Universal Analytics، تبحث عن موقع "إحصاءات Google‏ 4" المرتبط به.

get

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

getAttributionSettings

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

getDataRetentionSettings

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

getGoogleSignalsSettings

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

list

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

listConnectedSiteTags

 يسرد هذا التقرير علامات المواقع الإلكترونية المرتبطة لموقع على Universal Analytics.

patch

 تعديل موقع

provisionSubproperty

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

runAccessReport

 عرض تقرير مخصّص لسجلّات الوصول إلى البيانات

setAutomatedGa4ConfigurationOptOut

 تُستخدَم لضبط حالة إيقاف عملية إعداد "إحصاءات Google‏ 4" الآلي لموقع Universal Analytics.

updateAttributionSettings

 تعديل إعدادات تحديد المصدر في موقع

updateDataRetentionSettings

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

updateGoogleSignalsSettings

 تعديل إعدادات "إشارات Google" لموقع