REST Resource: properties

משאב: נכס

הודעת משאב שמייצגת נכס GA4 ב-Google Analytics.

ייצוג 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)

פלט בלבד. השעה שבה הישות נוצרה במקור.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

פלט בלבד. השעה שבה עודכנו לאחרונה שדות המטען הייעודי (payload) של הישות.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

parent

string

בלתי ניתן לשינוי. שם המשאב של ההורה הלוגי של הנכס הזה.

הערה: אפשר להשתמש בממשק המשתמש להעברת נכסים כדי לשנות את ההורה. פורמט: accounts/{account}, נכסים/{property} דוגמה: "accounts/100", "properties/101"

displayName

string

חובה. שם תצוגה של הנכס הזה שקריא לבני אדם.

האורך המקסימלי המותר של שם מוצג הוא 100 יחידות קוד UTF-16.

industryCategory

enum (IndustryCategory)

תעשייה המשויכת לנכס הזה. דוגמה: autoMOTIVE, FOOD_AND_DRINK

timeZone

string

חובה. אזור הזמן לדיווח, משמש כגבול היום לדוחות, ללא קשר למקור הנתונים. אם באזור הזמן יש שעון קיץ, מערכת Analytics תבצע התאמות באופן אוטומטי לפי השינויים.

הערה: שינוי אזור הזמן משפיע על נתונים רק החל מרגע השינוי, ואינו מוחל רטרואקטיבית.

פורמט: 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 Analytics שחלה על הנכס הזה.

deleteTime

string (Timestamp format)

פלט בלבד. אם המדיניות מוגדרת, השעה שבה הנכס הועבר לאשפה. אם המאפיין לא מוגדר, הנכס הזה לא נמצא כרגע באשפה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

פלט בלבד. אם המדיניות מוגדרת, השעה שבה הנכס שהועבר לאשפה יימחק באופן סופי. אם המדיניות לא מוגדרת, הנכס הזה לא נמצא כרגע בפח האשפה ולא מיועד למחיקה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

account

string

בלתי ניתן לשינוי. שם המשאב בפורמט של חשבון ההורה: accounts/{account_id} דוגמה: "accounts/123"

PropertyType

סוגי המשאבים של הנכסים.

טיפוסים בני מנייה (enum)
PROPERTY_TYPE_UNSPECIFIED סוג הנכס לא ידוע או שלא צוין
PROPERTY_TYPE_ORDINARY נכס GA4 רגיל
PROPERTY_TYPE_SUBPROPERTY נכס משנה של GA4
PROPERTY_TYPE_ROLLUP נכס-על GA4

IndustryCategory

הקטגוריה שנבחרה לנכס הזה, שמשמשת להשוואה לשוק.

טיפוסים בני מנייה (enum)
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 Analytics.

טיפוסים בני מנייה (enum)
SERVICE_LEVEL_UNSPECIFIED רמת השירות לא צוינה או לא חוקית.
GOOGLE_ANALYTICS_STANDARD הגרסה הרגילה של Google Analytics.
GOOGLE_ANALYTICS_360 גרסת הפרימיום בתשלום של Google Analytics.

שיטות

acknowledgeUserDataCollection

אישור התנאים של איסוף נתוני משתמשים בנכס שצוין.

create

יצירת 'GA4' נכס עם המיקום והמאפיינים שצוינו.

delete

סימון נכס היעד כ'נמחק עם יכולת שחזור' (כלומר, 'הועבר לאשפה') ומחזיר אותו.

get

חיפוש "GA4" יחיד מאפיין.

getDataRetentionSettings

מחזירה את ההגדרות של שמירת נתונים ב-Singleton של הנכס הזה.

list

הפונקציה מחזירה נכסי צאצא בחשבון ההורה שצוין.

patch

מעדכנות נכס.

runAccessReport

מחזירה דוח מותאם אישית של רשומות גישה לנתונים.

updateDataRetentionSettings

עדכון ההגדרות של שמירת נתונים ב-Singleton של הנכס הזה.