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, filter=None, pageToken=None, pageSize=None, view=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
    "params": { # The command message to execute, represented as a Struct.
      "a_key": "", # Properties of the object.
    },
    "command": "A String", # The command name to execute, represented by the fully qualified protobuf message name.
  }

  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.
    "assignee": "A String", # Output only. The name of the structure/room where the device is assigned to. For example: "enterprises/XYZ/structures/ABC" or "enterprises/XYZ/structures/ABC/rooms/123"
    "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.
    },
    "name": "A String", # Required. The resource name of the device. For example: "enterprises/XYZ/devices/123".
    "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.
  }
list(parent, filter=None, pageToken=None, pageSize=None, view=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)
  filter: string, Optional filter to list devices. Filters can match the exact assignee (could be a structure or a room). E.g. 'assignee=enterprises/XYZ/structures/abc' Also could filter by parent (group): 'parent=enterprises/XYZ/groups/jkl' or filter by device custom name (substring match): 'customName=wing'
  pageToken: string, Optional token of the page to retrieve.
  pageSize: integer, Optional requested page size. Server may return fewer devices than requested. If unspecified, server will pick an appropriate default.
  view: string, Additional details that need to be provided for the device.
    Allowed values
      DEVICE_DETAILS_VIEW_UNSPECIFIED - Default option this would return basic details for both Get and Listd Devices. Currently this view is supported only for device types, SPEAKER, DISPLAY,
      DEVICE_CONSOLE_VIEW - Selecting this option would return the structureId and structure name to which the device is assigned alongwith other basic details. Currently this view is supported only for device types -- sdm.devices.types.SPEAKER -- sdm.devices.types.CHROMECAST -- sdm.devices.types.DISPLAY -- sdm.devices.types.CAMERA Any other device type would only return a basic view during ListDevices invocation.
  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.
        "assignee": "A String", # Output only. The name of the structure/room where the device is assigned to. For example: "enterprises/XYZ/structures/ABC" or "enterprises/XYZ/structures/ABC/rooms/123"
        "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.
        },
        "name": "A String", # Required. The resource name of the device. For example: "enterprises/XYZ/devices/123".
        "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.
      },
    ],
  }
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.