Class: Google::Apis::AndroiddeviceprovisioningV1::AndroidProvisioningPartnerService

Inherits:
Core::BaseService
  • Object
show all
Defined in:
generated/google/apis/androiddeviceprovisioning_v1/service.rb

Overview

Android Device Provisioning Partner API

Automates Android zero-touch enrollment for device resellers, customers, and EMMs.

Examples:

require 'google/apis/androiddeviceprovisioning_v1'

Androiddeviceprovisioning = Google::Apis::AndroiddeviceprovisioningV1 # Alias the module
service = Androiddeviceprovisioning::AndroidProvisioningPartnerService.new

See Also:

Instance Attribute Summary collapse

Attributes inherited from Core::BaseService

#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path

Instance Method Summary collapse

Methods inherited from Core::BaseService

#batch, #batch_upload, #fetch_all, #http

Methods included from Core::Logging

#logger

Constructor Details

#initialize ⇒ AndroidProvisioningPartnerService

Returns a new instance of AndroidProvisioningPartnerService



46
47
48
49
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 46

def initialize
  super('https://androiddeviceprovisioning.googleapis.com/', '')
  @batch_path = 'batch'
end

Instance Attribute Details

#key ⇒ String

Returns API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

Returns:

  • (String) —

    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.



39
40
41
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 39

def key
  @key
end

#quota_user ⇒ String

Returns Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

Returns:

  • (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.



44
45
46
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 44

def quota_user
  @quota_user
end

Instance Method Details

#apply_customer_device_configuration(parent, customer_apply_configuration_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Empty

Applies a Configuration to the device to register the device for zero-touch enrollment. After applying a configuration to a device, the device automatically provisions itself on first boot, or next factory reset.

Parameters:

  • parent (String) —

    Required. The customer managing the device. An API resource name in the format customers/[CUSTOMER_ID].

  • customer_apply_configuration_request_object (Google::Apis::AndroiddeviceprovisioningV1::CustomerApplyConfigurationRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



280
281
282
283
284
285
286
287
288
289
290
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 280

def apply_customer_device_configuration(parent, customer_apply_configuration_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/{+parent}/devices:applyConfiguration', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerApplyConfigurationRequest::Representation
  command.request_object = customer_apply_configuration_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Empty::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Empty
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#claim_device(partner_id, claim_device_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::ClaimDeviceResponse

Claims a device for a customer and adds it to zero-touch enrollment. If the device is already claimed by another customer, the call returns an error.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • claim_device_request_object (Google::Apis::AndroiddeviceprovisioningV1::ClaimDeviceRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



595
596
597
598
599
600
601
602
603
604
605
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 595

def claim_device(partner_id, claim_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:claim', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::ClaimDeviceRequest::Representation
  command.request_object = claim_device_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::ClaimDeviceResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::ClaimDeviceResponse
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#claim_partner_device_async(partner_id, claim_devices_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Operation

Claims a batch of devices for a customer asynchronously. Adds the devices to zero-touch enrollment. To learn more, read Long‑running batch operations.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • claim_devices_request_object (Google::Apis::AndroiddeviceprovisioningV1::ClaimDevicesRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



630
631
632
633
634
635
636
637
638
639
640
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 630

def claim_partner_device_async(partner_id, claim_devices_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:claimAsync', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::ClaimDevicesRequest::Representation
  command.request_object = claim_devices_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Operation::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Operation
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_customer(parent, create_customer_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Company

Creates a customer for zero-touch enrollment. After the method returns successfully, admin and owner roles can manage devices and EMM configs by calling API methods or using their zero-touch enrollment portal. The customer receives an email that welcomes them to zero-touch enrollment and explains how to sign into the portal.

Parameters:

  • parent (String) —

    Required. The parent resource ID in the format partners/[PARTNER_ID] that identifies the reseller.

  • create_customer_request_object (Google::Apis::AndroiddeviceprovisioningV1::CreateCustomerRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



522
523
524
525
526
527
528
529
530
531
532
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 522

def create_customer(parent, create_customer_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/{+parent}/customers', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::CreateCustomerRequest::Representation
  command.request_object = create_customer_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Company::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Company
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_customer_configuration(parent, configuration_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Configuration

Creates a new configuration. Once created, a customer can apply the configuration to devices.

Parameters:

  • parent (String) —

    Required. The customer that manages the configuration. An API resource name in the format customers/[CUSTOMER_ID].

  • configuration_object (Google::Apis::AndroiddeviceprovisioningV1::Configuration) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



108
109
110
111
112
113
114
115
116
117
118
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 108

def create_customer_configuration(parent, configuration_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/{+parent}/configurations', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::Configuration::Representation
  command.request_object = configuration_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Configuration::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Configuration
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#delete_customer_configuration(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Empty

Deletes an unused configuration. The API call fails if the customer has devices with the configuration applied.

Parameters:

  • name (String) —

    Required. The configuration to delete. An API resource name in the format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. If the configuration is applied to any devices, the API call fails.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



143
144
145
146
147
148
149
150
151
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 143

def delete_customer_configuration(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:delete, 'v1/{+name}', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Empty::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Empty
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#find_partner_device_by_identifier(partner_id, find_devices_by_device_identifier_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByDeviceIdentifierResponse

Finds devices by hardware identifiers, such as IMEI.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • find_devices_by_device_identifier_request_object (Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByDeviceIdentifierRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



663
664
665
666
667
668
669
670
671
672
673
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 663

def find_partner_device_by_identifier(partner_id, find_devices_by_device_identifier_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:findByIdentifier', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByDeviceIdentifierRequest::Representation
  command.request_object = find_devices_by_device_identifier_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByDeviceIdentifierResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByDeviceIdentifierResponse
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#find_partner_device_by_owner(partner_id, find_devices_by_owner_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByOwnerResponse

Finds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the partnerId argument. The customer's devices purchased from other resellers don't appear in the results.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • find_devices_by_owner_request_object (Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByOwnerRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



699
700
701
702
703
704
705
706
707
708
709
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 699

def find_partner_device_by_owner(partner_id, find_devices_by_owner_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:findByOwner', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByOwnerRequest::Representation
  command.request_object = find_devices_by_owner_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByOwnerResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::FindDevicesByOwnerResponse
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_customer_configuration(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Configuration

Gets the details of a configuration.

Parameters:

  • name (String) —

    Required. The configuration to get. An API resource name in the format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID].

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



174
175
176
177
178
179
180
181
182
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 174

def get_customer_configuration(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+name}', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Configuration::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Configuration
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_customer_device(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Device

Gets the details of a device.

Parameters:

  • name (String) —

    Required. The device to get. An API resource name in the format customers/[CUSTOMER_ID]/devices/[DEVICE_ID].

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



313
314
315
316
317
318
319
320
321
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 313

def get_customer_device(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+name}', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Device::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Device
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_operation(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Operation

Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

Parameters:

  • name (String) —

    The name of the operation resource.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



486
487
488
489
490
491
492
493
494
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 486

def get_operation(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+name}', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Operation::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Operation
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_partner_device(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Device

Gets a device.

Parameters:

  • name (String) —

    Required. The device API resource name in the format partners/[PARTNER_ID]/devices/[DEVICE_ID].

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



732
733
734
735
736
737
738
739
740
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 732

def get_partner_device(name, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+name}', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Device::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Device
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_customer_configurations(parent, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::CustomerListConfigurationsResponse

Lists a customer's configurations.

Parameters:

  • parent (String) —

    Required. The customer that manages the listed configurations. An API resource name in the format customers/[CUSTOMER_ID].

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



205
206
207
208
209
210
211
212
213
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 205

def list_customer_configurations(parent, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+parent}/configurations', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerListConfigurationsResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::CustomerListConfigurationsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_customer_devices(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::CustomerListDevicesResponse

Lists a customer's devices.

Parameters:

  • parent (String) —

    Required. The customer managing the devices. An API resource name in the format customers/[CUSTOMER_ID].

  • page_size (Fixnum) —

    The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.

  • page_token (String) —

    A token specifying which result page to return.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



349
350
351
352
353
354
355
356
357
358
359
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 349

def list_customer_devices(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+parent}/devices', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerListDevicesResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::CustomerListDevicesResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_customer_dpcs(parent, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::CustomerListDpcsResponse

Lists the DPCs (device policy controllers) that support zero-touch enrollment.

Parameters:

  • parent (String) —

    Required. The customer that can use the DPCs in configurations. An API resource name in the format customers/[CUSTOMER_ID].

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



454
455
456
457
458
459
460
461
462
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 454

def list_customer_dpcs(parent, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+parent}/dpcs', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerListDpcsResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::CustomerListDpcsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_customers(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::CustomerListCustomersResponse

Lists the user's customer accounts.

Parameters:

  • page_size (Fixnum) —

    The maximum number of customers to show in a page of results. A number between 1 and 100 (inclusive).

  • page_token (String) —

    A token specifying which result page to return.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



74
75
76
77
78
79
80
81
82
83
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 74

def list_customers(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/customers', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerListCustomersResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::CustomerListCustomersResponse
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_partner_customers(partner_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::ListCustomersResponse

Lists the customers that are enrolled to the reseller identified by the partnerId argument. This list includes customers that the reseller created and customers that enrolled themselves using the portal.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • page_size (Fixnum) —

    The maximum number of results to be returned. If not specified or 0, all the records are returned.

  • page_token (String) —

    A token identifying a page of results returned by the server.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



561
562
563
564
565
566
567
568
569
570
571
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 561

def list_partner_customers(partner_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/partners/{+partnerId}/customers', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::ListCustomersResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::ListCustomersResponse
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_partner_vendor_customers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::ListVendorCustomersResponse

Lists the customers of the vendor.

Parameters:

  • parent (String) —

    Required. The resource name in the format partners/[PARTNER_ID]/vendors/[VENDOR_ID].

  • page_size (Fixnum) —

    The maximum number of results to be returned.

  • page_token (String) —

    A token identifying a page of results returned by the server.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



944
945
946
947
948
949
950
951
952
953
954
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 944

def list_partner_vendor_customers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+parent}/customers', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::ListVendorCustomersResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::ListVendorCustomersResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_partner_vendors(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::ListVendorsResponse

Lists the vendors of the partner.

Parameters:

  • parent (String) —

    Required. The resource name in the format partners/[PARTNER_ID].

  • page_size (Fixnum) —

    The maximum number of results to be returned.

  • page_token (String) —

    A token identifying a page of results returned by the server.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



907
908
909
910
911
912
913
914
915
916
917
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 907

def list_partner_vendors(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/{+parent}/vendors', options)
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::ListVendorsResponse::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::ListVendorsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#metadata_partner_device(metadata_owner_id, device_id, update_device_metadata_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata

Updates reseller metadata associated with the device.

Parameters:

  • metadata_owner_id (Fixnum) —

    Required. The owner of the newly set metadata. Set this to the partner ID.

  • device_id (Fixnum) —

    Required. The ID of the device.

  • update_device_metadata_request_object (Google::Apis::AndroiddeviceprovisioningV1::UpdateDeviceMetadataRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



765
766
767
768
769
770
771
772
773
774
775
776
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 765

def metadata_partner_device(metadata_owner_id, device_id, update_device_metadata_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+metadataOwnerId}/devices/{+deviceId}/metadata', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::UpdateDeviceMetadataRequest::Representation
  command.request_object = update_device_metadata_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::DeviceMetadata
  command.params['metadataOwnerId'] = metadata_owner_id unless metadata_owner_id.nil?
  command.params['deviceId'] = device_id unless device_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#patch_customer_configuration(name, configuration_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Configuration

Updates a configuration's field values.

Parameters:

  • name (String) —

    Output only. The API resource name in the format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Assigned by the server.

  • configuration_object (Google::Apis::AndroiddeviceprovisioningV1::Configuration) (defaults to: nil)
  • update_mask (String) —

    Required. The field mask applied to the target Configuration before updating the fields. To learn more about using field masks, read FieldMask in the Protocol Buffers documentation.

  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



243
244
245
246
247
248
249
250
251
252
253
254
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 243

def patch_customer_configuration(name, configuration_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:patch, 'v1/{+name}', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::Configuration::Representation
  command.request_object = configuration_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Configuration::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Configuration
  command.params['name'] = name unless name.nil?
  command.query['updateMask'] = update_mask unless update_mask.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#remove_customer_device_configuration(parent, customer_remove_configuration_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Empty

Removes a configuration from device.

Parameters:

  • parent (String) —

    Required. The customer managing the device in the format customers/[CUSTOMER_ID].

  • customer_remove_configuration_request_object (Google::Apis::AndroiddeviceprovisioningV1::CustomerRemoveConfigurationRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



383
384
385
386
387
388
389
390
391
392
393
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 383

def remove_customer_device_configuration(parent, customer_remove_configuration_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/{+parent}/devices:removeConfiguration', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerRemoveConfigurationRequest::Representation
  command.request_object = customer_remove_configuration_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Empty::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Empty
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#unclaim_customer_device(parent, customer_unclaim_device_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Empty

Unclaims a device from a customer and removes it from zero-touch enrollment. After removing a device, a customer must contact their reseller to register the device into zero-touch enrollment again.

Parameters:

  • parent (String) —

    Required. The customer managing the device. An API resource name in the format customers/[CUSTOMER_ID].

  • customer_unclaim_device_request_object (Google::Apis::AndroiddeviceprovisioningV1::CustomerUnclaimDeviceRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



420
421
422
423
424
425
426
427
428
429
430
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 420

def unclaim_customer_device(parent, customer_unclaim_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/{+parent}/devices:unclaim', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::CustomerUnclaimDeviceRequest::Representation
  command.request_object = customer_unclaim_device_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Empty::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Empty
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#unclaim_device(partner_id, unclaim_device_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Empty

Unclaims a device from a customer and removes it from zero-touch enrollment.

Parameters:

  • partner_id (Fixnum) —

    Required. The ID of the reseller partner.

  • unclaim_device_request_object (Google::Apis::AndroiddeviceprovisioningV1::UnclaimDeviceRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



800
801
802
803
804
805
806
807
808
809
810
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 800

def unclaim_device(partner_id, unclaim_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:unclaim', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::UnclaimDeviceRequest::Representation
  command.request_object = unclaim_device_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Empty::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Empty
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#unclaim_partner_device_async(partner_id, unclaim_devices_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Operation

Unclaims a batch of devices for a customer asynchronously. Removes the devices from zero-touch enrollment. To learn more, read Long‑running batch operations.

Parameters:

  • partner_id (Fixnum) —

    Required. The reseller partner ID.

  • unclaim_devices_request_object (Google::Apis::AndroiddeviceprovisioningV1::UnclaimDevicesRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



835
836
837
838
839
840
841
842
843
844
845
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 835

def unclaim_partner_device_async(partner_id, unclaim_devices_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:unclaimAsync', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::UnclaimDevicesRequest::Representation
  command.request_object = unclaim_devices_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Operation::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Operation
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#update_partner_device_metadata_async(partner_id, update_device_metadata_in_batch_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::AndroiddeviceprovisioningV1::Operation

Updates the reseller metadata attached to a batch of devices. This method updates devices asynchronously and returns an Operation that can be used to track progress. Read Long‑running batch operations.

Parameters:

  • partner_id (Fixnum) —

    Required. The reseller partner ID.

  • update_device_metadata_in_batch_request_object (Google::Apis::AndroiddeviceprovisioningV1::UpdateDeviceMetadataInBatchRequest) (defaults to: nil)
  • fields (String) —

    Selector specifying which fields to include in a partial response.

  • quota_user (String) —

    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

  • options (Google::Apis::RequestOptions) —

    Request-specific options

Yields:

  • (result, err) —

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



871
872
873
874
875
876
877
878
879
880
881
 
# File 'generated/google/apis/androiddeviceprovisioning_v1/service.rb', line 871

def update_partner_device_metadata_async(partner_id, update_device_metadata_in_batch_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:post, 'v1/partners/{+partnerId}/devices:updateMetadataAsync', options)
  command.request_representation = Google::Apis::AndroiddeviceprovisioningV1::UpdateDeviceMetadataInBatchRequest::Representation
  command.request_object = update_device_metadata_in_batch_request_object
  command.response_representation = Google::Apis::AndroiddeviceprovisioningV1::Operation::Representation
  command.response_class = Google::Apis::AndroiddeviceprovisioningV1::Operation
  command.params['partnerId'] = partner_id unless partner_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end