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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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

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

list

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

patch

تعديل موقع

provisionSubproperty

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

runAccessReport

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

submitUserDeletion

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

updateAttributionSettings

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

updateDataRetentionSettings

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

updateGoogleSignalsSettings

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