REST Resource: customers.profiles

משאב: ChromeBrowserProfile

ייצוג של פרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "name": string,
  "profileId": string,
  "profilePermanentId": string,
  "displayName": string,
  "userId": string,
  "userEmail": string,
  "lastActivityTime": string,
  "lastPolicyFetchTime": string,
  "lastPolicySyncTime": string,
  "lastStatusReportTime": string,
  "deviceInfo": {
    object (DeviceInfo)
  },
  "osPlatformType": string,
  "osVersion": string,
  "browserVersion": string,
  "browserChannel": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "attestationCredential": {
    object (AttestationCredential)
  },
  "reportingData": {
    object (ReportingData)
  },
  "etag": string,
  "identityProvider": enum (IdentityProvider),
  "firstEnrollmentTime": string,
  "affiliationState": enum (AffiliationState),
  "policyCount": string,
  "extensionCount": string,
  "osPlatformVersion": string
}
שדות
name

string

מזהה. פורמט: customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

פלט בלבד. מזהה הפרופיל בצד הלקוח של Chrome.
profilePermanentId

string

פלט בלבד. המזהה הקבוע של הפרופיל הוא המזהה הייחודי של פרופיל בלקוח אחד.
displayName

string

פלט בלבד. השם המוצג של הפרופיל שהוגדר על ידי הלקוח.
userId

string

פלט בלבד. מזהה Directory API ייחודי של המשתמש שאפשר להשתמש בו ב-Admin SDK Users API.
userEmail

string

פלט בלבד. כתובת האימייל של המשתמש שפרופיל התשלומים שייך לו.
lastActivityTime

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".
lastPolicyFetchTime

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".
lastPolicySyncTime

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".
lastStatusReportTime

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".
deviceInfo

object (DeviceInfo)

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

string

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

string

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

string

פלט בלבד. גרסת הדפדפן שבו הפרופיל קיים.
browserChannel

string

פלט בלבד. הערוץ של הדפדפן שבו הפרופיל קיים.
annotatedLocation

string

זה שינוי אופציונלי. המיקום של הפרופיל שעליו האדמין הוסיף הערה.
annotatedUser

string

זה שינוי אופציונלי. משתמש בפרופיל שהאדמין הוסיף לו הערות.
attestationCredential

object (AttestationCredential)

פלט בלבד. פרטי פרטי הכניסה לאימות של הפרופיל.
reportingData

object (ReportingData)

פלט בלבד. נתוני דיווח מפורטים של הפרופיל. המידע הזה זמין רק כשמדיניות הדיווח על הפרופיל מופעלת.
etag

string

פלט בלבד. ה-Etag של המשאב ChromeBrowserProfile. אפשר להשתמש ב-etag הזה עם פעולת UPDATE כדי להבטיח עקביות.
identityProvider

enum (IdentityProvider)

פלט בלבד. זיהוי הספק של הפרופיל.
firstEnrollmentTime

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".
affiliationState

enum (AffiliationState)

פלט בלבד. מצב השותפות הספציפי של הפרופיל.
policyCount

string (int64 format)

פלט בלבד. מספר כללי המדיניות שהוחלו על הפרופיל.
extensionCount

string (int64 format)

פלט בלבד. מספר התוספים שמותקנים בפרופיל.
osPlatformVersion

string

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

DeviceInfo

מידע על מכשיר שבו פועל פרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
שדות
deviceType

enum (DeviceType)

פלט בלבד. סוג המכשיר שבו הפרופיל קיים.
affiliatedDeviceId

string

פלט בלבד. מזהה המכשיר שמזהה את המכשיר המשויך שבו נמצא הפרופיל. אם סוג המכשיר הוא CHROME_BROWSER, הוא מייצג מזהה Directory API ייחודי של המכשיר שאפשר להשתמש בו ב-Admin SDK Browsers API.
machine

string

פלט בלבד. שם המכונה של המכשיר שבו נמצא הפרופיל. בפלטפורמות שלא מדווחות על שם המכונה (נכון לעכשיו, iOS ו-Android), השדה הזה מוגדר במקום זאת כ-deviceId של הדפדפן – אבל חשוב לזכור שזהו deviceId שונה מ-|affiliatedDeviceId|.
hostname

string

פלט בלבד. שם המארח של המכשיר שבו נמצא הפרופיל.

DeviceType

סוגי המכשירים האפשריים.

טיפוסים בני מנייה (enum)
DEVICE_TYPE_UNSPECIFIED מייצג סוג מכשיר לא צוין.
CHROME_BROWSER מייצג מכשיר עם דפדפן Chrome.

AttestationCredential

מידע על מפתח ציבורי שמשויך לפרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
שדות
keyType

enum (KeyType)

פלט בלבד. הסוג של המפתח הציבורי.
keyTrustLevel

enum (KeyTrustLevel)

פלט בלבד. רמת האמון במפתח הציבורי.
publicKey

string (bytes format)

פלט בלבד. הערך של המפתח הציבורי.

מחרוזת בקידוד Base64.
keyRotationTime

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".

KeyType

סוגי מפתחות ציבוריים אפשריים.

טיפוסים בני מנייה (enum)
KEY_TYPE_UNSPECIFIED מייצג סוג מפתח ציבורי לא צוין.
RSA_KEY מייצג מפתח RSA.
EC_KEY מייצג מפתח EC.

KeyTrustLevel

רמות האמון האפשריות של מפתח ציבורי.

טיפוסים בני מנייה (enum)
KEY_TRUST_LEVEL_UNSPECIFIED מייצג רמת אמון לא מצוינות של מפתח ציבורי.
CHROME_BROWSER_HW_KEY מייצג מפתח חומרה.
CHROME_BROWSER_OS_KEY מייצג מפתח של מערכת הפעלה.

ReportingData

דיווח על נתונים של פרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
שדות
browserExecutablePath

string

פלט בלבד. נתיב קובץ ההפעלה של דפדפן Chrome שהותקן. נתיב תקף נכלל רק בפרופילים של שותפים עצמאיים.
installedBrowserVersion

string

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

string

פלט בלבד. הנתיב של הפרופיל. נתיב תקף נכלל רק בפרופילים של שותפים עצמאיים.
extensionData[]

object (ExtensionData)

פלט בלבד. מידע על התוספים שמותקנים בפרופיל.
policyData[]

object (PolicyData)

פלט בלבד. מידע על כללי המדיניות שחלים על הפרופיל.
extensionPolicyData[]

object (ExtensionPolicyData)

פלט בלבד. מידע על כללי המדיניות שחלים על התוספים.

ExtensionData

מידע על תוסף שמותקן בפרופיל של דפדפן Chrome.

ייצוג ב-JSON 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "name": string,
  "description": string,
  "extensionType": enum (ExtensionType),
  "homepageUri": string,
  "installationType": enum (InstallationType),
  "manifestVersion": integer,
  "isDisabled": boolean,
  "isWebstoreExtension": boolean
}
שדות
extensionId

string

פלט בלבד. המזהה של התוסף.
version

string

פלט בלבד. גרסת התוסף.
permissions[]

string

פלט בלבד. ההרשאות שהתוסף ביקש.
name

string

פלט בלבד. שם התוסף.
description

string

פלט בלבד. תיאור התוסף.
extensionType

enum (ExtensionType)

פלט בלבד. סוג התוסף.
homepageUri

string

פלט בלבד. כתובת ה-URL של דף הבית של התוסף.
installationType

enum (InstallationType)

פלט בלבד. סוג ההתקנה של התוסף.
manifestVersion

integer

פלט בלבד. גרסת המניפסט של התוסף.
isDisabled

boolean

פלט בלבד. הערך הזה מייצג אם המשתמש השבית את התוסף.
isWebstoreExtension

boolean

פלט בלבד. מציין אם התוסף הגיע מחנות האינטרנט.

ExtensionType

סוגי התוספים האפשריים.

טיפוסים בני מנייה (enum)
EXTENSION_TYPE_UNSPECIFIED מייצג סוג תוסף לא צוין.
EXTENSION מייצג תוסף.
APP מייצג אפליקציה.
THEME מייצג עיצוב.
HOSTED_APP מייצג אפליקציה מתארחת.

InstallationType

סוגי ההתקנות האפשריים של תוסף.

טיפוסים בני מנייה (enum)
INSTALLATION_TYPE_UNSPECIFIED מייצג סוג התקנה לא צוין.
MULTIPLE מייצג מופעים של התוסף עם סוגי התקנה מעורבים.
NORMAL מייצג סוג התקנה רגיל.
ADMIN מייצג התקנה על ידי אדמין.
DEVELOPMENT מייצג סוג התקנה לפיתוח.
SIDELOAD סוג התקנה של טעינה צדדית.
OTHER מייצג סוג התקנה שלא מופיע באפשרויות האחרות.

PolicyData

מידע על מדיניות שחלה על פרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
שדות
source

enum (PolicySource)

פלט בלבד. מקור המדיניות.
name

string

פלט בלבד. שם המדיניות.
value

string

פלט בלבד. הערך של המדיניות.
conflicts[]

object (ConflictingPolicyData)

פלט בלבד. מידע סותרי על המדיניות.
error

string

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

PolicySource

מקורות אפשריים של מדיניות.

טיפוסים בני מנייה (enum)
POLICY_SOURCE_UNSPECIFIED מייצג מקור מדיניות לא צוין.
MACHINE_PLATFORM מייצג מדיניות פלטפורמה ברמת המכונה.
USER_PLATFORM מייצג מדיניות פלטפורמה ברמת המשתמש.
MACHINE_LEVEL_USER_CLOUD מייצג מדיניות ענן ברמת המשתמש ברמת המכונה.
USER_CLOUD מייצג מדיניות ענן ברמת המשתמש.
MACHINE_MERGED מייצג מדיניות משולבת ברמת המכונה.

ConflictingPolicyData

מידע על מדיניות מתנגשת שחלה על פרופיל בדפדפן Chrome.

ייצוג ב-JSON 
{
  "source": enum (PolicySource)
}
שדות
source

enum (PolicySource)

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

ExtensionPolicyData

מידע על כללי המדיניות שחלים על תוסף.

ייצוג ב-JSON 
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
שדות
extensionId

string

פלט בלבד. המזהה של התוסף.
extensionName

string

פלט בלבד. שם התוסף.
policyData[]

object (PolicyData)

פלט בלבד. מידע על כללי המדיניות שחלים על התוסף.

IdentityProvider

ספקי הזהויות האפשריים של פרופיל.

טיפוסים בני מנייה (enum)
IDENTITY_PROVIDER_UNSPECIFIED מייצג ספק זהויות לא צוין.
GOOGLE_IDENTITY_PROVIDER מייצג ספק זהויות של Google.
EXTERNAL_IDENTITY_PROVIDER מייצג ספק זהויות חיצוני.

AffiliationState

מצב השותפות הספציפי של הפרופיל. יכול להיות שנוסיף ערכים חדשים בעתיד.

טיפוסים בני מנייה (enum)
AFFILIATION_STATE_UNSPECIFIED מצב השותפות לא צוין.
UNAFFILIATED_GENERIC ללא שיוך – אבל אין לנו את הפרטים לגבי סוג הפרופיל ללא שיוך.
PROFILE_ONLY ללא קשר – פרופיל מנוהל שמופיע בדפדפן שלא מנוהל בכלל.
UNAFFILIATED_LOCAL_MACHINE ללא שיוך – פרופיל מנוהל שמופיע במכונה שמנוהלת באופן מקומי על ידי ארגון אחר (באמצעות מנגנוני ניהול פלטפורמה כמו GPO).
UNAFFILIATED_CLOUD_MACHINE ללא שיוך – פרופיל מנוהל שמופיע בדפדפן מנוהל שמנוהל בענן על ידי ארגון אחר (באמצעות ממשק מרכזי לניהול דפדפן Chrome).
AFFILIATED_CLOUD_MANAGED משויך – גם הפרופיל וגם הדפדפן המנוהל מנוהלים על ידי אותו ארגון.

Methods

delete

 מחיקה של הנתונים שנאספו מפרופיל בדפדפן Chrome.

get

 הפונקציה מקבלת פרופיל בדפדפן Chrome עם מזהה לקוח ומזהה קבוע של פרופיל.

list

 הצגת רשימה של פרופילים של דפדפן Chrome של לקוח על סמך קריטריונים נתונים של חיפוש ומיון.