1393 lines
88 KiB
Ruby
1393 lines
88 KiB
Ruby
# Copyright 2015 Google Inc.
|
||
#
|
||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||
# you may not use this file except in compliance with the License.
|
||
# You may obtain a copy of the License at
|
||
#
|
||
# http://www.apache.org/licenses/LICENSE-2.0
|
||
#
|
||
# Unless required by applicable law or agreed to in writing, software
|
||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
# See the License for the specific language governing permissions and
|
||
# limitations under the License.
|
||
|
||
require 'google/apis/core/base_service'
|
||
require 'google/apis/core/json_representation'
|
||
require 'google/apis/core/hashable'
|
||
require 'google/apis/errors'
|
||
|
||
module Google
|
||
module Apis
|
||
module CloudidentityV1beta1
|
||
# Cloud Identity API
|
||
#
|
||
# API for provisioning and managing identity resources.
|
||
#
|
||
# @example
|
||
# require 'google/apis/cloudidentity_v1beta1'
|
||
#
|
||
# Cloudidentity = Google::Apis::CloudidentityV1beta1 # Alias the module
|
||
# service = Cloudidentity::CloudIdentityService.new
|
||
#
|
||
# @see https://cloud.google.com/identity/
|
||
class CloudIdentityService < Google::Apis::Core::BaseService
|
||
# @return [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.
|
||
attr_accessor :key
|
||
|
||
# @return [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.
|
||
attr_accessor :quota_user
|
||
|
||
def initialize
|
||
super('https://cloudidentity.googleapis.com/', '')
|
||
@batch_path = 'batch'
|
||
end
|
||
|
||
# Cancels an unfinished device wipe. This operation can be used to cancel device
|
||
# wipe in the gap between the wipe operation returning success and the device
|
||
# being wiped.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id``, where device_id is the unique
|
||
# ID assigned to the Device, and device_user_id is the unique ID assigned to the
|
||
# User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::CancelWipeDeviceRequest] cancel_wipe_device_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def cancel_wipe_device(name, cancel_wipe_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:cancelWipe', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::CancelWipeDeviceRequest::Representation
|
||
command.request_object = cancel_wipe_device_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Creates a device. Only company-owned device may be created.
|
||
# @param [Google::Apis::CloudidentityV1beta1::CreateDeviceRequest] create_device_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def create_device(create_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/devices', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::CreateDeviceRequest::Representation
|
||
command.request_object = create_device_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Deletes the specified device.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id``, where device_id is the unique
|
||
# ID assigned to the Device.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def delete_device(name, customer: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:delete, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Retrieves the specified device.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id``, where device_id is the unique
|
||
# ID assigned to the Device.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Customer in format: `customers/`customer_id``, where customer_id is the
|
||
# customer to whom the device belongs.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Device] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Device]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_device(name, customer: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Device::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Device
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Lists/Searches devices.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer.
|
||
# @param [String] filter
|
||
# Optional. Additional restrictions when fetching list of devices. [HC article
|
||
# link](https://support.google.com/a/answer/7549103)
|
||
# @param [String] order_by
|
||
# Optional. Order specification for devices in the response. Only one of the
|
||
# following field names may be used to specify the order: `create_time`, `
|
||
# last_sync_time`, `model`, `os_version`, `device_type` and `serial_number`. `
|
||
# desc` may be specified optionally to specify results to be sorted in
|
||
# descending order. Default order is ascending.
|
||
# @param [Fixnum] page_size
|
||
# Optional. The maximum number of Devices to return. If unspecified, at most 20
|
||
# Devices will be returned. The maximum value is 100; values above 100 will be
|
||
# coerced to 100.
|
||
# @param [String] page_token
|
||
# Optional. A page token, received from a previous `ListDevices` call. Provide
|
||
# this to retrieve the subsequent page. When paginating, all other parameters
|
||
# provided to `ListDevices` must match the call that provided the page token.
|
||
# @param [String] view
|
||
# Optional. The view to use for the List request.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ListDevicesResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ListDevicesResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def list_devices(customer: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/devices', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ListDevicesResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ListDevicesResponse
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['filter'] = filter unless filter.nil?
|
||
command.query['orderBy'] = order_by unless order_by.nil?
|
||
command.query['pageSize'] = page_size unless page_size.nil?
|
||
command.query['pageToken'] = page_token unless page_token.nil?
|
||
command.query['view'] = view unless view.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Wipes all data on the specified device.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::WipeDeviceRequest] wipe_device_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def wipe_device(name, wipe_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:wipe', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::WipeDeviceRequest::Representation
|
||
command.request_object = wipe_device_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Approves device to access user data.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::ApproveDeviceUserRequest] approve_device_user_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def approve_device_user(name, approve_device_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:approve', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::ApproveDeviceUserRequest::Representation
|
||
command.request_object = approve_device_user_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Blocks device from accessing user data
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::BlockDeviceUserRequest] block_device_user_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def block_device_user(name, block_device_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:block', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::BlockDeviceUserRequest::Representation
|
||
command.request_object = block_device_user_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Cancels an unfinished user account wipe. This operation can be used to cancel
|
||
# device wipe in the gap between the wipe operation returning success and the
|
||
# device being wiped.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::CancelWipeDeviceUserRequest] cancel_wipe_device_user_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def cancel_wipe_device_user(name, cancel_wipe_device_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:cancelWipe', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::CancelWipeDeviceUserRequest::Representation
|
||
command.request_object = cancel_wipe_device_user_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Deletes the specified DeviceUser. This also revokes the user's access to
|
||
# device data.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def delete_device_device_user(name, customer: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:delete, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Retrieves the specified DeviceUser
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::DeviceUser] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::DeviceUser]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_device_device_user(name, customer: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::DeviceUser::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::DeviceUser
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Lists/Searches DeviceUsers.
|
||
# @param [String] parent
|
||
# Required. To list all DeviceUsers, set this to "devices/-". To list all
|
||
# DeviceUsers owned by a device, set this to the resource name of the device.
|
||
# Format: devices/`device`
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] filter
|
||
# Optional. Additional restrictions when fetching list of devices. [HC article](
|
||
# https://support.google.com/a/answer/7549103)
|
||
# @param [String] order_by
|
||
# Optional. Order specification for devices in the response.
|
||
# @param [Fixnum] page_size
|
||
# Optional. The maximum number of DeviceUsers to return. If unspecified, at most
|
||
# 5 DeviceUsers will be returned. The maximum value is 20; values above 20 will
|
||
# be coerced to 20.
|
||
# @param [String] page_token
|
||
# Optional. A page token, received from a previous `ListDeviceUsers` call.
|
||
# Provide this to retrieve the subsequent page. When paginating, all other
|
||
# parameters provided to `ListBooks` must match the call that provided the page
|
||
# token.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ListDeviceUsersResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ListDeviceUsersResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def list_device_device_users(parent, customer: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/deviceUsers', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ListDeviceUsersResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ListDeviceUsersResponse
|
||
command.params['parent'] = parent unless parent.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['filter'] = filter unless filter.nil?
|
||
command.query['orderBy'] = order_by unless order_by.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
|
||
|
||
# Looks up resource names of the DeviceUsers associated with the caller's
|
||
# credentials, as well as the properties provided in the request. This method
|
||
# must be called with end-user credentials with the scope: https://www.
|
||
# googleapis.com/auth/cloud-identity.devices.lookup If multiple properties are
|
||
# provided, only DeviceUsers having all of these properties are considered as
|
||
# matches - i.e. the query behaves like an AND. Different platforms require
|
||
# different amounts of information from the caller to ensure that the DeviceUser
|
||
# is uniquely identified. - iOS: No properties need to be passed, the caller's
|
||
# credentials are sufficient to identify the corresponding DeviceUser. - Android:
|
||
# Specifying the 'android_id' field is required. - Desktop: Specifying the '
|
||
# raw_resource_id' field is required.
|
||
# @param [String] parent
|
||
# Must be set to "devices/-/deviceUsers" to search across all DeviceUser
|
||
# belonging to the user.
|
||
# @param [String] android_id
|
||
# Android Id returned by [Settings.Secure#ANDROID_ID](https://developer.android.
|
||
# com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
|
||
# @param [Fixnum] page_size
|
||
# The maximum number of DeviceUsers to return. If unspecified, at most 20
|
||
# DeviceUsers will be returned. The maximum value is 20; values above 20 will be
|
||
# coerced to 20.
|
||
# @param [String] page_token
|
||
# A page token, received from a previous `LookupDeviceUsers` call. Provide this
|
||
# to retrieve the subsequent page. When paginating, all other parameters
|
||
# provided to `LookupDeviceUsers` must match the call that provided the page
|
||
# token.
|
||
# @param [String] raw_resource_id
|
||
# Raw Resource Id used by Google Endpoint Verification. If the user is enrolled
|
||
# into Google Endpoint Verification, this id will be saved as the '
|
||
# device_resource_id' field in the following platform dependent files. Mac: ~/.
|
||
# secureConnect/context_aware_config.json Windows: C:\Users\%USERPROFILE%\.
|
||
# secureConnect\context_aware_config.json Linux: ~/.secureConnect/
|
||
# context_aware_config.json
|
||
# @param [String] user_id
|
||
# The user whose DeviceUser's resource name will be fetched. Must be set to 'me'
|
||
# to fetch the DeviceUser's resource name for the calling user.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::LookupSelfDeviceUsersResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::LookupSelfDeviceUsersResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def lookup_device_device_user(parent, android_id: nil, page_size: nil, page_token: nil, raw_resource_id: nil, user_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}:lookup', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::LookupSelfDeviceUsersResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::LookupSelfDeviceUsersResponse
|
||
command.params['parent'] = parent unless parent.nil?
|
||
command.query['androidId'] = android_id unless android_id.nil?
|
||
command.query['pageSize'] = page_size unless page_size.nil?
|
||
command.query['pageToken'] = page_token unless page_token.nil?
|
||
command.query['rawResourceId'] = raw_resource_id unless raw_resource_id.nil?
|
||
command.query['userId'] = user_id unless user_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
|
||
|
||
# Wipes the user's account on a device.
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the Device in format: `devices/`device_id`/deviceUsers/`device_user_id``,
|
||
# where device_id is the unique ID assigned to the Device, and device_user_id is
|
||
# the unique ID assigned to the User.
|
||
# @param [Google::Apis::CloudidentityV1beta1::WipeDeviceUserRequest] wipe_device_user_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def wipe_device_user(name, wipe_device_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:wipe', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::WipeDeviceUserRequest::Representation
|
||
command.request_object = wipe_device_user_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Gets the client state for the device user
|
||
# @param [String] name
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the ClientState in format: `devices/`device_id`/deviceUsers/`device_user_id`
|
||
# /clientStates/`partner_id``, where device_id is the unique ID assigned to the
|
||
# Device, device_user_id is the unique ID assigned to the User and partner_id
|
||
# identifies the partner storing the data.
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ClientState] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ClientState]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_device_device_user_client_state(name, customer: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ClientState::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ClientState
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Updates the client state for the device user
|
||
# @param [String] name
|
||
# Output only. [Resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the ClientState in format: `devices/`device_id`/deviceUsers/
|
||
# `device_user_id`/clientState/`partner_id``, where partner_id corresponds to
|
||
# the partner storing the data.
|
||
# @param [Google::Apis::CloudidentityV1beta1::ClientState] client_state_object
|
||
# @param [String] customer
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the customer. If you're using this API for your own organization, use `
|
||
# customers/my_customer` If you're using this API to manage another organization,
|
||
# use `customers/`customer_id``, where customer_id is the customer to whom the
|
||
# device belongs.
|
||
# @param [String] update_mask
|
||
# Optional. Comma-separated list of fully qualified names of fields to be
|
||
# updated. If not specified, all updatable fields in ClientState are updated.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def patch_device_device_user_client_state(name, client_state_object = nil, customer: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:patch, 'v1beta1/{+name}', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::ClientState::Representation
|
||
command.request_object = client_state_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.params['name'] = name unless name.nil?
|
||
command.query['customer'] = customer unless customer.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
|
||
|
||
# Creates a `Group`.
|
||
# @param [Google::Apis::CloudidentityV1beta1::Group] group_object
|
||
# @param [String] initial_group_config
|
||
# Required. The initial configuration option for the `Group`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def create_group(group_object = nil, initial_group_config: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/groups', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::Group::Representation
|
||
command.request_object = group_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.query['initialGroupConfig'] = initial_group_config unless initial_group_config.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Deletes a `Group`.
|
||
# @param [String] name
|
||
# Required. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Group` to retrieve. Must be of the form `groups/`
|
||
# group_id``.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def delete_group(name, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:delete, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Retrieves a `Group`.
|
||
# @param [String] name
|
||
# Required. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Group` to retrieve. Must be of the form `groups/`
|
||
# group_id``.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Group] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Group]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_group(name, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Group::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Group
|
||
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
|
||
|
||
# Lists the `Group`s under a customer or namespace.
|
||
# @param [Fixnum] page_size
|
||
# The maximum number of results to return. Note that the number of results
|
||
# returned may be less than this value even if there are more available results.
|
||
# To fetch all results, clients must continue calling this method repeatedly
|
||
# until the response no longer contains a `next_page_token`. If unspecified,
|
||
# defaults to 200 for `View.BASIC` and to 50 for `View.FULL`. Must not be
|
||
# greater than 1000 for `View.BASIC` or 500 for `View.FULL`.
|
||
# @param [String] page_token
|
||
# The `next_page_token` value returned from a previous list request, if any.
|
||
# @param [String] parent
|
||
# Required. The parent resource under which to list all `Group`s. Must be of the
|
||
# form `identitysources/`identity_source_id`` for external- identity-mapped
|
||
# groups or `customers/`customer_id`` for Google Groups.
|
||
# @param [String] view
|
||
# The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ListGroupsResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ListGroupsResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def list_groups(page_size: nil, page_token: nil, parent: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/groups', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ListGroupsResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ListGroupsResponse
|
||
command.query['pageSize'] = page_size unless page_size.nil?
|
||
command.query['pageToken'] = page_token unless page_token.nil?
|
||
command.query['parent'] = parent unless parent.nil?
|
||
command.query['view'] = view unless view.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Looks up the [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of a `Group` by its `EntityKey`.
|
||
# @param [String] group_key_id
|
||
# The ID of the entity. For Google-managed entities, the `id` must be the email
|
||
# address of an existing group or user. For external-identity-mapped entities,
|
||
# the `id` must be a string conforming to the Identity Source's requirements.
|
||
# Must be unique within a `namespace`.
|
||
# @param [String] group_key_namespace
|
||
# The namespace in which the entity exists. If not specified, the `EntityKey`
|
||
# represents a Google-managed entity such as a Google user or a Google Group. If
|
||
# specified, the `EntityKey` represents an external-identity-mapped group. The
|
||
# namespace must correspond to an identity source created in Admin Console and
|
||
# must be in the form of `identitysources/`identity_source_id`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::LookupGroupNameResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::LookupGroupNameResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def lookup_group(group_key_id: nil, group_key_namespace: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/groups:lookup', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::LookupGroupNameResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::LookupGroupNameResponse
|
||
command.query['groupKey.id'] = group_key_id unless group_key_id.nil?
|
||
command.query['groupKey.namespace'] = group_key_namespace unless group_key_namespace.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Updates a `Group`.
|
||
# @param [String] name
|
||
# Output only. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Group`. Shall be of the form `groups/`group_id``.
|
||
# @param [Google::Apis::CloudidentityV1beta1::Group] group_object
|
||
# @param [String] update_mask
|
||
# Required. The fully-qualified names of fields to update. May only contain the
|
||
# following fields: `display_name`, `description`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def patch_group(name, group_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:patch, 'v1beta1/{+name}', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::Group::Representation
|
||
command.request_object = group_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
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
|
||
|
||
# Searches for `Group`s matching a specified query.
|
||
# @param [Fixnum] page_size
|
||
# The maximum number of results to return. Note that the number of results
|
||
# returned may be less than this value even if there are more available results.
|
||
# To fetch all results, clients must continue calling this method repeatedly
|
||
# until the response no longer contains a `next_page_token`. If unspecified,
|
||
# defaults to 200 for `GroupView.BASIC` and to 50 for `GroupView.FULL`. Must not
|
||
# be greater than 1000 for `GroupView.BASIC` or 500 for `GroupView.FULL`.
|
||
# @param [String] page_token
|
||
# The `next_page_token` value returned from a previous search request, if any.
|
||
# @param [String] query
|
||
# Required. The search query. Must be specified in [Common Expression Language](
|
||
# https://opensource.google/projects/cel). May only contain equality operators
|
||
# on the parent and inclusion operators on labels (e.g., `parent == 'customers/`
|
||
# customer_id`' && 'cloudidentity.googleapis.com/groups.discussion_forum' in
|
||
# labels`).
|
||
# @param [String] view
|
||
# The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::SearchGroupsResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::SearchGroupsResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def search_groups(page_size: nil, page_token: nil, query: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/groups:search', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::SearchGroupsResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::SearchGroupsResponse
|
||
command.query['pageSize'] = page_size unless page_size.nil?
|
||
command.query['pageToken'] = page_token unless page_token.nil?
|
||
command.query['query'] = query unless query.nil?
|
||
command.query['view'] = view unless view.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Check a potential member for membership in a group.
|
||
# @param [String] parent
|
||
# [Resource name](https://cloud.google.com/apis/design/resource_names) of the
|
||
# group to check the transitive membership in. Format: `groups/`group_id``,
|
||
# where `group_id` is the unique id assigned to the Group to which the
|
||
# Membership belongs to.
|
||
# @param [String] query
|
||
# Required. A CEL expression that MUST include member specification. This is a `
|
||
# required` field. Example query: member_key_id == ‘member_key_id_value’ [ &&
|
||
# member_key_namespace == ‘member_key_namespace_value’ ]
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::CheckTransitiveMembershipResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::CheckTransitiveMembershipResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def check_group_membership_transitive_membership(parent, query: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships:checkTransitiveMembership', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::CheckTransitiveMembershipResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::CheckTransitiveMembershipResponse
|
||
command.params['parent'] = parent unless parent.nil?
|
||
command.query['query'] = query unless query.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Creates a `Membership`.
|
||
# @param [String] parent
|
||
# Required. The parent `Group` resource under which to create the `Membership`.
|
||
# Must be of the form `groups/`group_id``.
|
||
# @param [Google::Apis::CloudidentityV1beta1::Membership] membership_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def create_group_membership(parent, membership_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+parent}/memberships', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::Membership::Representation
|
||
command.request_object = membership_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
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
|
||
|
||
# Deletes a `Membership`.
|
||
# @param [String] name
|
||
# Required. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Membership` to delete. Must be of the form `groups/`
|
||
# group_id`/memberships/`membership_id``.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def delete_group_membership(name, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:delete, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::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
|
||
|
||
# Retrieves a `Membership`.
|
||
# @param [String] name
|
||
# Required. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Membership` to retrieve. Must be of the form `groups/`
|
||
# group_id`/memberships/`membership_id``.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Membership] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Membership]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_group_membership(name, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+name}', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Membership::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Membership
|
||
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 a membership graph of a member or member/group.
|
||
# @param [String] parent
|
||
# Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
|
||
# of the group to search transitive memberships in. Format: `groups/`group_id``,
|
||
# where `group_id` is the unique ID assigned to the Group to which the
|
||
# Membership belongs to. group_id can be a wildcard collection id "-". When a
|
||
# group_id is specified, the membership graph will be constrained to paths
|
||
# between the member (defined in the query) and the parent. If a wildcard
|
||
# collection is provided, all membership paths connected to the member will be
|
||
# returned.
|
||
# @param [String] query
|
||
# Required. A CEL expression that MUST include member specification AND label(s).
|
||
# Example query: member_key_id == ‘member_key_id_value’ [ &&
|
||
# member_key_namespace == ‘member_key_namespace_value’ ] && in labels
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::Operation] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::Operation]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def get_group_membership_membership_graph(parent, query: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships:getMembershipGraph', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::Operation::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::Operation
|
||
command.params['parent'] = parent unless parent.nil?
|
||
command.query['query'] = query unless query.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Lists the `Membership`s within a `Group`.
|
||
# @param [String] parent
|
||
# Required. The parent `Group` resource under which to lookup the `Membership`
|
||
# name. Must be of the form `groups/`group_id``.
|
||
# @param [Fixnum] page_size
|
||
# The maximum number of results to return. Note that the number of results
|
||
# returned may be less than this value even if there are more available results.
|
||
# To fetch all results, clients must continue calling this method repeatedly
|
||
# until the response no longer contains a `next_page_token`. If unspecified,
|
||
# defaults to 200 for `GroupView.BASIC` and to 50 for `GroupView.FULL`. Must not
|
||
# be greater than 1000 for `GroupView.BASIC` or 500 for `GroupView.FULL`.
|
||
# @param [String] page_token
|
||
# The `next_page_token` value returned from a previous search request, if any.
|
||
# @param [String] view
|
||
# The level of detail to be returned. If unspecified, defaults to `
|
||
# MembershipView.BASIC`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ListMembershipsResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ListMembershipsResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def list_group_memberships(parent, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ListMembershipsResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ListMembershipsResponse
|
||
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['view'] = view unless view.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Looks up the [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of a `Membership` by its `EntityKey`.
|
||
# @param [String] parent
|
||
# Required. The parent `Group` resource under which to lookup the `Membership`
|
||
# name. Must be of the form `groups/`group_id``.
|
||
# @param [String] member_key_id
|
||
# The ID of the entity. For Google-managed entities, the `id` must be the email
|
||
# address of an existing group or user. For external-identity-mapped entities,
|
||
# the `id` must be a string conforming to the Identity Source's requirements.
|
||
# Must be unique within a `namespace`.
|
||
# @param [String] member_key_namespace
|
||
# The namespace in which the entity exists. If not specified, the `EntityKey`
|
||
# represents a Google-managed entity such as a Google user or a Google Group. If
|
||
# specified, the `EntityKey` represents an external-identity-mapped group. The
|
||
# namespace must correspond to an identity source created in Admin Console and
|
||
# must be in the form of `identitysources/`identity_source_id`.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::LookupMembershipNameResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::LookupMembershipNameResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def lookup_group_membership(parent, member_key_id: nil, member_key_namespace: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships:lookup', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::LookupMembershipNameResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::LookupMembershipNameResponse
|
||
command.params['parent'] = parent unless parent.nil?
|
||
command.query['memberKey.id'] = member_key_id unless member_key_id.nil?
|
||
command.query['memberKey.namespace'] = member_key_namespace unless member_key_namespace.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Modifies the `MembershipRole`s of a `Membership`.
|
||
# @param [String] name
|
||
# Required. The [resource name](https://cloud.google.com/apis/design/
|
||
# resource_names) of the `Membership` whose roles are to be modified. Must be of
|
||
# the form `groups/`group_id`/memberships/`membership_id``.
|
||
# @param [Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesRequest] modify_membership_roles_request_object
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def modify_membership_roles(name, modify_membership_roles_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:post, 'v1beta1/{+name}:modifyMembershipRoles', options)
|
||
command.request_representation = Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesRequest::Representation
|
||
command.request_object = modify_membership_roles_request_object
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::ModifyMembershipRolesResponse
|
||
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
|
||
|
||
# Search transitive groups of a member.
|
||
# @param [String] parent
|
||
# [Resource name](https://cloud.google.com/apis/design/resource_names) of the
|
||
# group to search transitive memberships in. Format: `groups/`group_id``, where `
|
||
# group_id` is always '-' as this API will search across all groups for a given
|
||
# member.
|
||
# @param [Fixnum] page_size
|
||
# The default page size is 200 (max 1000).
|
||
# @param [String] page_token
|
||
# The next_page_token value returned from a previous list request, if any.
|
||
# @param [String] query
|
||
# Required. A CEL expression that MUST include member specification AND label(s).
|
||
# This is a `required` field. Users can search on label attributes of groups.
|
||
# CONTAINS match ('in') is supported on labels. Example query: member_key_id == ‘
|
||
# member_key_id_value’ [ && member_key_namespace == ‘member_key_namespace_value’
|
||
# ] && in labels
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::SearchTransitiveGroupsResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::SearchTransitiveGroupsResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def search_group_membership_transitive_groups(parent, page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships:searchTransitiveGroups', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::SearchTransitiveGroupsResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::SearchTransitiveGroupsResponse
|
||
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['query'] = query unless query.nil?
|
||
command.query['fields'] = fields unless fields.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
execute_or_queue_command(command, &block)
|
||
end
|
||
|
||
# Search transitive memberships of a group.
|
||
# @param [String] parent
|
||
# [Resource name](https://cloud.google.com/apis/design/resource_names) of the
|
||
# group to search transitive memberships in. Format: `groups/`group_id``, where `
|
||
# group_id` is the unique ID assigned to the Group.
|
||
# @param [Fixnum] page_size
|
||
# The default page size is 200 (max 1000).
|
||
# @param [String] page_token
|
||
# The next_page_token value returned from a previous list request, if any.
|
||
# @param [String] fields
|
||
# Selector specifying which fields to include in a partial response.
|
||
# @param [String] quota_user
|
||
# 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.
|
||
# @param [Google::Apis::RequestOptions] options
|
||
# Request-specific options
|
||
#
|
||
# @yield [result, err] Result & error if block supplied
|
||
# @yieldparam result [Google::Apis::CloudidentityV1beta1::SearchTransitiveMembershipsResponse] parsed result object
|
||
# @yieldparam err [StandardError] error object if request failed
|
||
#
|
||
# @return [Google::Apis::CloudidentityV1beta1::SearchTransitiveMembershipsResponse]
|
||
#
|
||
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
||
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
||
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
||
def search_group_membership_transitive_memberships(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
||
command = make_simple_command(:get, 'v1beta1/{+parent}/memberships:searchTransitiveMemberships', options)
|
||
command.response_representation = Google::Apis::CloudidentityV1beta1::SearchTransitiveMembershipsResponse::Representation
|
||
command.response_class = Google::Apis::CloudidentityV1beta1::SearchTransitiveMembershipsResponse
|
||
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
|
||
|
||
protected
|
||
|
||
def apply_command_defaults(command)
|
||
command.query['key'] = key unless key.nil?
|
||
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
||
end
|
||
end
|
||
end
|
||
end
|
||
end
|