Chrome Management API . customers . profiles

Instance Methods

close()

Close httplib2 connections.

delete(name, x__xgafv=None)

Deletes the data collected from a Chrome browser profile.

get(name, x__xgafv=None)

Gets a Chrome browser profile with customer ID and profile permanent ID.

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Chrome browser profiles of a customer based on the given search and sorting criteria.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
delete(name, x__xgafv=None)
Deletes the data collected from a Chrome browser profile.

Args:
  name: string, Required. Format: customers/{customer_id}/profiles/{profile_permanent_id} (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
get(name, x__xgafv=None)
Gets a Chrome browser profile with customer ID and profile permanent ID.

Args:
  name: string, Required. Format: customers/{customer_id}/profiles/{profile_permanent_id} (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A representation of a Chrome browser profile.
  "affiliationState": "A String", # Output only. The specific affiliation state of the profile.
  "annotatedLocation": "A String", # Optional. Location of the profile annotated by the admin.
  "annotatedUser": "A String", # Optional. User of the profile annotated by the admin.
  "attestationCredential": { # Information of public key associated with a Chrome browser profile. # Output only. Attestation credential information of the profile.
    "keyRotationTime": "A String", # Output only. Latest rotation timestamp of the public key rotation.
    "keyTrustLevel": "A String", # Output only. Trust level of the public key.
    "keyType": "A String", # Output only. Type of the public key.
    "publicKey": "A String", # Output only. Value of the public key.
  },
  "browserChannel": "A String", # Output only. Channel of the browser on which the profile exists.
  "browserVersion": "A String", # Output only. Version of the browser on which the profile exists.
  "deviceInfo": { # Information of a device that runs a Chrome browser profile. # Output only. Basic information of the device on which the profile exists. This information is only available for the affiliated profiles.
    "affiliatedDeviceId": "A String", # Output only. Device ID that identifies the affiliated device on which the profile exists. If the device type is CHROME_BROWSER, then this represents a unique Directory API ID of the device that can be used in Admin SDK Browsers API.
    "deviceType": "A String", # Output only. Type of the device on which the profile exists.
    "hostname": "A String", # Output only. Hostname of the device on which the profile exists.
    "machine": "A String", # Output only. Machine name of the device on which the profile exists. On platforms which do not report the machine name (currently iOS and Android) this is instead set to the browser's device_id - but note that this is a different device_id than the |affiliated_device_id|.
  },
  "displayName": "A String", # Output only. Profile display name set by client.
  "etag": "A String", # Output only. Etag of this ChromeBrowserProfile resource. This etag can be used with UPDATE operation to ensure consistency.
  "extensionCount": "A String", # Output only. Number of extensions installed on the profile.
  "firstEnrollmentTime": "A String", # Output only. Timestamp of the first enrollment of the profile.
  "identityProvider": "A String", # Output only. Identify provider of the profile.
  "lastActivityTime": "A String", # Output only. Timestamp of the latest activity by the profile.
  "lastPolicyFetchTime": "A String", # Output only. Timestamp of the latest policy fetch by the profile.
  "lastPolicySyncTime": "A String", # Output only. Timestamp of the latest policy sync by the profile.
  "lastStatusReportTime": "A String", # Output only. Timestamp of the latest status report by the profile.
  "name": "A String", # Identifier. Format: customers/{customer_id}/profiles/{profile_permanent_id}
  "osPlatformType": "A String", # Output only. OS platform of the device on which the profile exists.
  "osPlatformVersion": "A String", # Output only. Major OS version of the device on which the profile exists. (i.e. Windows 10)
  "osVersion": "A String", # Output only. OS version of the device on which the profile exists.
  "policyCount": "A String", # Output only. Number of policies applied on the profile.
  "profileId": "A String", # Output only. Chrome client side profile ID.
  "profilePermanentId": "A String", # Output only. Profile permanent ID is the unique identifier of a profile within one customer.
  "reportingData": { # Reporting data of a Chrome browser profile. # Output only. Detailed reporting data of the profile. This information is only available when the profile reporting policy is enabled.
    "browserExecutablePath": "A String", # Output only. Executable path of the installed Chrome browser. A valid path is included only in affiliated profiles.
    "extensionData": [ # Output only. Information of the extensions installed on the profile.
      { # Information of an extension installed on a Chrome browser profile.
        "description": "A String", # Output only. Description of the extension.
        "extensionId": "A String", # Output only. ID of the extension.
        "extensionType": "A String", # Output only. Type of the extension.
        "homepageUri": "A String", # Output only. The URL of the homepage of the extension.
        "installationType": "A String", # Output only. Installation type of the extension.
        "isDisabled": True or False, # Output only. Represents whether the user disabled the extension.
        "isWebstoreExtension": True or False, # Output only. Represents whether the extension is from the webstore.
        "manifestVersion": 42, # Output only. Manifest version of the extension.
        "name": "A String", # Output only. Name of the extension.
        "permissions": [ # Output only. Permissions requested by the extension.
          "A String",
        ],
        "version": "A String", # Output only. Version of the extension.
      },
    ],
    "extensionPolicyData": [ # Output only. Information of the policies applied on the extensions.
      { # Information of the policies applied on an extension.
        "extensionId": "A String", # Output only. ID of the extension.
        "extensionName": "A String", # Output only. Name of the extension.
        "policyData": [ # Output only. Information of the policies applied on the extension.
          { # Information of a policy applied on a Chrome browser profile.
            "conflicts": [ # Output only. Conflicting policy information.
              { # Information of conflicting policy applied on a Chrome browser profile.
                "source": "A String", # Output only. Source of the policy.
              },
            ],
            "error": "A String", # Output only. Error message of the policy, if any.
            "name": "A String", # Output only. Name of the policy.
            "source": "A String", # Output only. Source of the policy.
            "value": "A String", # Output only. Value of the policy.
          },
        ],
      },
    ],
    "installedBrowserVersion": "A String", # Output only. Updated version of a browser, if it is different from the active browser version.
    "policyData": [ # Output only. Information of the policies applied on the profile.
      { # Information of a policy applied on a Chrome browser profile.
        "conflicts": [ # Output only. Conflicting policy information.
          { # Information of conflicting policy applied on a Chrome browser profile.
            "source": "A String", # Output only. Source of the policy.
          },
        ],
        "error": "A String", # Output only. Error message of the policy, if any.
        "name": "A String", # Output only. Name of the policy.
        "source": "A String", # Output only. Source of the policy.
        "value": "A String", # Output only. Value of the policy.
      },
    ],
    "profilePath": "A String", # Output only. Path of the profile. A valid path is included only in affiliated profiles.
  },
  "userEmail": "A String", # Output only. Email address of the user to which the profile belongs.
  "userId": "A String", # Output only. Unique Directory API ID of the user that can be used in Admin SDK Users API.
}
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists Chrome browser profiles of a customer based on the given search and sorting criteria.

Args:
  parent: string, Required. Format: customers/{customer_id} (required)
  filter: string, Optional. The filter used to filter profiles. The following fields can be used in the filter: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state - ouId Any of the above fields can be used to specify a filter, and filtering by multiple fields is supported with AND operator. String type fields and enum type fields support '=' and '!=' operators. The integer type and the timestamp type fields support '=', '!=', '<', '>', '<=' and '>=' operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard '*' can be used with a string type field filter. In addition, string literal filtering is also supported, for example, 'ABC' as a filter maps to a filter that checks if any of the filterable string type fields contains 'ABC'. Organization unit number can be used as a filtering criteria here by specifying 'ouId = ${your_org_unit_id}', please note that only single OU ID matching is supported.
  orderBy: string, Optional. The fields used to specify the ordering of the results. The supported fields are: - profile_id - display_name - user_email - last_activity_time - last_policy_sync_time - last_status_report_time - first_enrollment_time - os_platform_type - os_version - browser_version - browser_channel - policy_count - extension_count - identity_provider - affiliation_state By default, sorting is in ascending order, to specify descending order for a field, a suffix " desc" should be added to the field name. The default ordering is the descending order of last_status_report_time.
  pageSize: integer, Optional. The maximum number of profiles to return. The default page size is 100 if page_size is unspecified, and the maximum page size allowed is 200.
  pageToken: string, Optional. The page token used to retrieve a specific page of the listing request.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response to ListChromeBrowserProfiles method.
  "chromeBrowserProfiles": [ # The list of profiles returned.
    { # A representation of a Chrome browser profile.
      "affiliationState": "A String", # Output only. The specific affiliation state of the profile.
      "annotatedLocation": "A String", # Optional. Location of the profile annotated by the admin.
      "annotatedUser": "A String", # Optional. User of the profile annotated by the admin.
      "attestationCredential": { # Information of public key associated with a Chrome browser profile. # Output only. Attestation credential information of the profile.
        "keyRotationTime": "A String", # Output only. Latest rotation timestamp of the public key rotation.
        "keyTrustLevel": "A String", # Output only. Trust level of the public key.
        "keyType": "A String", # Output only. Type of the public key.
        "publicKey": "A String", # Output only. Value of the public key.
      },
      "browserChannel": "A String", # Output only. Channel of the browser on which the profile exists.
      "browserVersion": "A String", # Output only. Version of the browser on which the profile exists.
      "deviceInfo": { # Information of a device that runs a Chrome browser profile. # Output only. Basic information of the device on which the profile exists. This information is only available for the affiliated profiles.
        "affiliatedDeviceId": "A String", # Output only. Device ID that identifies the affiliated device on which the profile exists. If the device type is CHROME_BROWSER, then this represents a unique Directory API ID of the device that can be used in Admin SDK Browsers API.
        "deviceType": "A String", # Output only. Type of the device on which the profile exists.
        "hostname": "A String", # Output only. Hostname of the device on which the profile exists.
        "machine": "A String", # Output only. Machine name of the device on which the profile exists. On platforms which do not report the machine name (currently iOS and Android) this is instead set to the browser's device_id - but note that this is a different device_id than the |affiliated_device_id|.
      },
      "displayName": "A String", # Output only. Profile display name set by client.
      "etag": "A String", # Output only. Etag of this ChromeBrowserProfile resource. This etag can be used with UPDATE operation to ensure consistency.
      "extensionCount": "A String", # Output only. Number of extensions installed on the profile.
      "firstEnrollmentTime": "A String", # Output only. Timestamp of the first enrollment of the profile.
      "identityProvider": "A String", # Output only. Identify provider of the profile.
      "lastActivityTime": "A String", # Output only. Timestamp of the latest activity by the profile.
      "lastPolicyFetchTime": "A String", # Output only. Timestamp of the latest policy fetch by the profile.
      "lastPolicySyncTime": "A String", # Output only. Timestamp of the latest policy sync by the profile.
      "lastStatusReportTime": "A String", # Output only. Timestamp of the latest status report by the profile.
      "name": "A String", # Identifier. Format: customers/{customer_id}/profiles/{profile_permanent_id}
      "osPlatformType": "A String", # Output only. OS platform of the device on which the profile exists.
      "osPlatformVersion": "A String", # Output only. Major OS version of the device on which the profile exists. (i.e. Windows 10)
      "osVersion": "A String", # Output only. OS version of the device on which the profile exists.
      "policyCount": "A String", # Output only. Number of policies applied on the profile.
      "profileId": "A String", # Output only. Chrome client side profile ID.
      "profilePermanentId": "A String", # Output only. Profile permanent ID is the unique identifier of a profile within one customer.
      "reportingData": { # Reporting data of a Chrome browser profile. # Output only. Detailed reporting data of the profile. This information is only available when the profile reporting policy is enabled.
        "browserExecutablePath": "A String", # Output only. Executable path of the installed Chrome browser. A valid path is included only in affiliated profiles.
        "extensionData": [ # Output only. Information of the extensions installed on the profile.
          { # Information of an extension installed on a Chrome browser profile.
            "description": "A String", # Output only. Description of the extension.
            "extensionId": "A String", # Output only. ID of the extension.
            "extensionType": "A String", # Output only. Type of the extension.
            "homepageUri": "A String", # Output only. The URL of the homepage of the extension.
            "installationType": "A String", # Output only. Installation type of the extension.
            "isDisabled": True or False, # Output only. Represents whether the user disabled the extension.
            "isWebstoreExtension": True or False, # Output only. Represents whether the extension is from the webstore.
            "manifestVersion": 42, # Output only. Manifest version of the extension.
            "name": "A String", # Output only. Name of the extension.
            "permissions": [ # Output only. Permissions requested by the extension.
              "A String",
            ],
            "version": "A String", # Output only. Version of the extension.
          },
        ],
        "extensionPolicyData": [ # Output only. Information of the policies applied on the extensions.
          { # Information of the policies applied on an extension.
            "extensionId": "A String", # Output only. ID of the extension.
            "extensionName": "A String", # Output only. Name of the extension.
            "policyData": [ # Output only. Information of the policies applied on the extension.
              { # Information of a policy applied on a Chrome browser profile.
                "conflicts": [ # Output only. Conflicting policy information.
                  { # Information of conflicting policy applied on a Chrome browser profile.
                    "source": "A String", # Output only. Source of the policy.
                  },
                ],
                "error": "A String", # Output only. Error message of the policy, if any.
                "name": "A String", # Output only. Name of the policy.
                "source": "A String", # Output only. Source of the policy.
                "value": "A String", # Output only. Value of the policy.
              },
            ],
          },
        ],
        "installedBrowserVersion": "A String", # Output only. Updated version of a browser, if it is different from the active browser version.
        "policyData": [ # Output only. Information of the policies applied on the profile.
          { # Information of a policy applied on a Chrome browser profile.
            "conflicts": [ # Output only. Conflicting policy information.
              { # Information of conflicting policy applied on a Chrome browser profile.
                "source": "A String", # Output only. Source of the policy.
              },
            ],
            "error": "A String", # Output only. Error message of the policy, if any.
            "name": "A String", # Output only. Name of the policy.
            "source": "A String", # Output only. Source of the policy.
            "value": "A String", # Output only. Value of the policy.
          },
        ],
        "profilePath": "A String", # Output only. Path of the profile. A valid path is included only in affiliated profiles.
      },
      "userEmail": "A String", # Output only. Email address of the user to which the profile belongs.
      "userId": "A String", # Output only. Unique Directory API ID of the user that can be used in Admin SDK Users API.
    },
  ],
  "nextPageToken": "A String", # The pagination token that can be used to list the next page.
  "totalSize": "A String", # Total size represents an estimated number of resources returned. Not guaranteed to be accurate above 10k profiles.
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.