Smart Device Management API . enterprises . devices

Instance Methods

close()

Close httplib2 connections.

executeCommand(name, body=None, x__xgafv=None)

Executes a command to device managed by the enterprise.

get(name, x__xgafv=None)

Gets a device managed by the enterprise.

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

Lists devices managed by the enterprise.

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
executeCommand(name, body=None, x__xgafv=None)
Executes a command to device managed by the enterprise.

Args:
  name: string, The name of the device requested. For example: "enterprises/XYZ/devices/123" (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for SmartDeviceManagementService.ExecuteDeviceCommand
    "command": "A String", # The command name to execute, represented by the fully qualified protobuf message name.
    "params": { # The command message to execute, represented as a Struct.
      "a_key": "", # Properties of the object.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for SmartDeviceManagementService.ExecuteDeviceCommand
    "results": { # The results of executing the command.
      "a_key": "", # Properties of the object.
    },
  }
get(name, x__xgafv=None)
Gets a device managed by the enterprise.

Args:
  name: string, The name of the device requested. For example: "enterprises/XYZ/devices/123" (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Device resource represents an instance of enterprise managed device in the property.
    "parentRelations": [ # Assignee details of the device.
      { # Represents device relationships, for instance, structure/room to which the device is assigned to. For now this is only filled in the enterprise flow.
        "displayName": "A String", # Output only. The custom name of the relation -- e.g., structure/room where the device is assigned to.
        "parent": "A String", # Output only. The name of the relation -- e.g., structure/room where the device is assigned to. For example: "enterprises/XYZ/structures/ABC" or "enterprises/XYZ/structures/ABC/rooms/123"
      },
    ],
    "traits": { # Output only. Device traits.
      "a_key": "", # Properties of the object.
    },
    "type": "A String", # Output only. Type of the device for general display purposes. For example: "THERMOSTAT". The device type should not be used to deduce or infer functionality of the actual device it is assigned to. Instead, use the returned traits for the device.
    "name": "A String", # Required. The resource name of the device. For example: "enterprises/XYZ/devices/123".
  }
list(parent, pageToken=None, filter=None, pageSize=None, x__xgafv=None)
Lists devices managed by the enterprise.

Args:
  parent: string, The parent enterprise to list devices under. E.g. "enterprises/XYZ". (required)
  pageToken: string, Optional token of the page to retrieve.
  filter: string, Optional filter to list devices. Filters can be done on: Device custom name (substring match): 'customName=wing'
  pageSize: integer, Optional requested page size. Server may return fewer devices than requested. If unspecified, server will pick an appropriate default.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for SmartDeviceManagementService.ListDevices
    "nextPageToken": "A String", # The pagination token to retrieve the next page of results.
    "devices": [ # The list of devices.
      { # Device resource represents an instance of enterprise managed device in the property.
        "parentRelations": [ # Assignee details of the device.
          { # Represents device relationships, for instance, structure/room to which the device is assigned to. For now this is only filled in the enterprise flow.
            "displayName": "A String", # Output only. The custom name of the relation -- e.g., structure/room where the device is assigned to.
            "parent": "A String", # Output only. The name of the relation -- e.g., structure/room where the device is assigned to. For example: "enterprises/XYZ/structures/ABC" or "enterprises/XYZ/structures/ABC/rooms/123"
          },
        ],
        "traits": { # Output only. Device traits.
          "a_key": "", # Properties of the object.
        },
        "type": "A String", # Output only. Type of the device for general display purposes. For example: "THERMOSTAT". The device type should not be used to deduce or infer functionality of the actual device it is assigned to. Instead, use the returned traits for the device.
        "name": "A String", # Required. The resource name of the device. For example: "enterprises/XYZ/devices/123".
      },
    ],
  }
list_next(previous_request, previous_response)
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.