diff --git a/accesscontextmanager/v1beta/accesscontextmanager-api.json b/accesscontextmanager/v1beta/accesscontextmanager-api.json index 37783283b01..39cf4b537a7 100644 --- a/accesscontextmanager/v1beta/accesscontextmanager-api.json +++ b/accesscontextmanager/v1beta/accesscontextmanager-api.json @@ -598,11 +598,11 @@ } } }, - "revision": "20181013", + "revision": "20181219", "rootUrl": "https://accesscontextmanager.googleapis.com/", "schemas": { "AccessLevel": { - "description": "An `AccessLevel` is a label that can be applied to requests to GCP services,\nalong with a list of requirements necessary for the label to be applied.\n`AccessLevels` can be referenced in `AccessZones` and in the `Cloud Org\nPolicy` API.", + "description": "An `AccessLevel` is a label that can be applied to requests to GCP services,\nalong with a list of requirements necessary for the label to be applied.", "id": "AccessLevel", "properties": { "basic": { diff --git a/accesscontextmanager/v1beta/accesscontextmanager-gen.go b/accesscontextmanager/v1beta/accesscontextmanager-gen.go index 3b2fefce1c9..be5895122a1 100644 --- a/accesscontextmanager/v1beta/accesscontextmanager-gen.go +++ b/accesscontextmanager/v1beta/accesscontextmanager-gen.go @@ -129,9 +129,6 @@ type OperationsService struct { // requests to GCP services, // along with a list of requirements necessary for the label to be // applied. -// `AccessLevels` can be referenced in `AccessZones` and in the `Cloud -// Org -// Policy` API. type AccessLevel struct { // Basic: A `BasicLevel` composed of `Conditions`. Basic *BasicLevel `json:"basic,omitempty"` diff --git a/api-list.json b/api-list.json index ba9c0aaa82f..f643fae7034 100644 --- a/api-list.json +++ b/api-list.json @@ -784,6 +784,21 @@ "documentationLink": "https://cloud.google.com/functions", "preferred": false }, + { + "kind": "discovery#directoryItem", + "id": "cloudidentity:v1", + "name": "cloudidentity", + "version": "v1", + "title": "Cloud Identity API", + "description": "API for provisioning and managing identity resources.", + "discoveryRestUrl": "https://cloudidentity.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/identity/", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "cloudidentity:v1beta1", @@ -797,7 +812,7 @@ "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" }, "documentationLink": "https://cloud.google.com/identity/", - "preferred": true + "preferred": false }, { "kind": "discovery#directoryItem", diff --git a/appengine/v1/appengine-api.json b/appengine/v1/appengine-api.json index 3805a7407a1..e2ba353c7ad 100644 --- a/appengine/v1/appengine-api.json +++ b/appengine/v1/appengine-api.json @@ -1572,7 +1572,7 @@ } } }, - "revision": "20181120", + "revision": "20181218", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -3552,6 +3552,10 @@ "description": "The channel of the runtime to use. Only available for some runtimes. Defaults to the default channel.", "type": "string" }, + "runtimeMainExecutablePath": { + "description": "The path or name of the app's main executable.", + "type": "string" + }, "servingStatus": { "description": "Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.", "enum": [ diff --git a/appengine/v1/appengine-gen.go b/appengine/v1/appengine-gen.go index f51bde62590..9244d8bb974 100644 --- a/appengine/v1/appengine-gen.go +++ b/appengine/v1/appengine-gen.go @@ -3532,6 +3532,10 @@ type Version struct { // some runtimes. Defaults to the default channel. RuntimeChannel string `json:"runtimeChannel,omitempty"` + // RuntimeMainExecutablePath: The path or name of the app's main + // executable. + RuntimeMainExecutablePath string `json:"runtimeMainExecutablePath,omitempty"` + // ServingStatus: Current serving status of this version. Only the // versions with a SERVING status create instances and can be // billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to diff --git a/appengine/v1beta/appengine-api.json b/appengine/v1beta/appengine-api.json index 4acc2d2bff9..470bc91a578 100644 --- a/appengine/v1beta/appengine-api.json +++ b/appengine/v1beta/appengine-api.json @@ -1572,7 +1572,7 @@ } } }, - "revision": "20181120", + "revision": "20181218", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -3629,6 +3629,10 @@ "description": "The channel of the runtime to use. Only available for some runtimes. Defaults to the default channel.", "type": "string" }, + "runtimeMainExecutablePath": { + "description": "The path or name of the app's main executable.", + "type": "string" + }, "servingStatus": { "description": "Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.", "enum": [ diff --git a/appengine/v1beta/appengine-gen.go b/appengine/v1beta/appengine-gen.go index 32c5cc1048c..9d12f32a977 100644 --- a/appengine/v1beta/appengine-gen.go +++ b/appengine/v1beta/appengine-gen.go @@ -3675,6 +3675,10 @@ type Version struct { // some runtimes. Defaults to the default channel. RuntimeChannel string `json:"runtimeChannel,omitempty"` + // RuntimeMainExecutablePath: The path or name of the app's main + // executable. + RuntimeMainExecutablePath string `json:"runtimeMainExecutablePath,omitempty"` + // ServingStatus: Current serving status of this version. Only the // versions with a SERVING status create instances and can be // billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to diff --git a/appengine/v1beta4/appengine-api.json b/appengine/v1beta4/appengine-api.json index 79fb98f8397..76933f25fd3 100644 --- a/appengine/v1beta4/appengine-api.json +++ b/appengine/v1beta4/appengine-api.json @@ -927,7 +927,7 @@ } } }, - "revision": "20181020", + "revision": "20181218", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -2413,6 +2413,10 @@ "description": "The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/\u003clanguage\u003e/config/appref", "type": "string" }, + "runtimeMainExecutablePath": { + "description": "The path or name of the app's main executable.", + "type": "string" + }, "servingStatus": { "description": "Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.", "enum": [ diff --git a/appengine/v1beta4/appengine-gen.go b/appengine/v1beta4/appengine-gen.go index 268579b2cb0..0b57653b782 100644 --- a/appengine/v1beta4/appengine-gen.go +++ b/appengine/v1beta4/appengine-gen.go @@ -2556,6 +2556,10 @@ type Version struct { // https://cloud.google.com/appengine/docs/standard//config/appref RuntimeApiVersion string `json:"runtimeApiVersion,omitempty"` + // RuntimeMainExecutablePath: The path or name of the app's main + // executable. + RuntimeMainExecutablePath string `json:"runtimeMainExecutablePath,omitempty"` + // ServingStatus: Current serving status of this version. Only the // versions with a SERVING status create instances and can be // billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to diff --git a/appengine/v1beta5/appengine-api.json b/appengine/v1beta5/appengine-api.json index 34435bad53d..dbf75036cec 100644 --- a/appengine/v1beta5/appengine-api.json +++ b/appengine/v1beta5/appengine-api.json @@ -927,7 +927,7 @@ } } }, - "revision": "20181020", + "revision": "20181218", "rootUrl": "https://appengine.googleapis.com/", "schemas": { "ApiConfigHandler": { @@ -2383,6 +2383,10 @@ "description": "The version of the API in the given runtime environment. Please see the app.yaml reference for valid values at https://cloud.google.com/appengine/docs/standard/\u003clanguage\u003e/config/appref", "type": "string" }, + "runtimeMainExecutablePath": { + "description": "The path or name of the app's main executable.", + "type": "string" + }, "servingStatus": { "description": "Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to SERVING.", "enum": [ diff --git a/appengine/v1beta5/appengine-gen.go b/appengine/v1beta5/appengine-gen.go index bce409b28bf..f1a4631acd7 100644 --- a/appengine/v1beta5/appengine-gen.go +++ b/appengine/v1beta5/appengine-gen.go @@ -2515,6 +2515,10 @@ type Version struct { // https://cloud.google.com/appengine/docs/standard//config/appref RuntimeApiVersion string `json:"runtimeApiVersion,omitempty"` + // RuntimeMainExecutablePath: The path or name of the app's main + // executable. + RuntimeMainExecutablePath string `json:"runtimeMainExecutablePath,omitempty"` + // ServingStatus: Current serving status of this version. Only the // versions with a SERVING status create instances and can be // billed.SERVING_STATUS_UNSPECIFIED is an invalid value. Defaults to diff --git a/cloudidentity/v1/cloudidentity-api.json b/cloudidentity/v1/cloudidentity-api.json new file mode 100644 index 00000000000..5cdaa00114e --- /dev/null +++ b/cloudidentity/v1/cloudidentity-api.json @@ -0,0 +1,688 @@ +{ + "basePath": "", + "baseUrl": "https://cloudidentity.googleapis.com/", + "batchPath": "batch", + "canonicalName": "Cloud Identity", + "description": "API for provisioning and managing identity resources.", + "discoveryVersion": "v1", + "documentationLink": "https://cloud.google.com/identity/", + "fullyEncodeReservedExpansion": true, + "icons": { + "x16": "http://www.google.com/images/icons/product/search-16.gif", + "x32": "http://www.google.com/images/icons/product/search-32.gif" + }, + "id": "cloudidentity:v1", + "kind": "discovery#restDescription", + "name": "cloudidentity", + "ownerDomain": "google.com", + "ownerName": "Google", + "parameters": { + "$.xgafv": { + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query", + "type": "string" + }, + "access_token": { + "description": "OAuth access token.", + "location": "query", + "type": "string" + }, + "alt": { + "default": "json", + "description": "Data format for response.", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query", + "type": "string" + }, + "callback": { + "description": "JSONP", + "location": "query", + "type": "string" + }, + "fields": { + "description": "Selector specifying which fields to include in a partial response.", + "location": "query", + "type": "string" + }, + "key": { + "description": "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.", + "location": "query", + "type": "string" + }, + "oauth_token": { + "description": "OAuth 2.0 token for the current user.", + "location": "query", + "type": "string" + }, + "prettyPrint": { + "default": "true", + "description": "Returns response with indentations and line breaks.", + "location": "query", + "type": "boolean" + }, + "quotaUser": { + "description": "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.", + "location": "query", + "type": "string" + }, + "uploadType": { + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query", + "type": "string" + }, + "upload_protocol": { + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query", + "type": "string" + } + }, + "protocol": "rest", + "resources": { + "groups": { + "methods": { + "create": { + "description": "Creates a Group.", + "flatPath": "v1/groups", + "httpMethod": "POST", + "id": "cloudidentity.groups.create", + "parameterOrder": [], + "parameters": {}, + "path": "v1/groups", + "request": { + "$ref": "Group" + }, + "response": { + "$ref": "Operation" + } + }, + "delete": { + "description": "Deletes a Group.", + "flatPath": "v1/groups/{groupsId}", + "httpMethod": "DELETE", + "id": "cloudidentity.groups.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where `group_id` is the unique ID\nassigned to the Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + } + }, + "get": { + "description": "Retrieves a Group.", + "flatPath": "v1/groups/{groupsId}", + "httpMethod": "GET", + "id": "cloudidentity.groups.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where `group_id` is the unique ID\nassigned to the Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Group" + } + }, + "list": { + "description": "List groups within a customer or a domain.", + "flatPath": "v1/groups", + "httpMethod": "GET", + "id": "cloudidentity.groups.list", + "parameterOrder": [], + "parameters": { + "pageSize": { + "description": "Maximum number of Groups to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The next_page_token value returned from a previous list request, if any.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "`Required`. May be made Optional in the future.\nCustomer ID to list all groups from.", + "location": "query", + "type": "string" + }, + "view": { + "description": "Group resource view to be returned. Defaults to [View.BASIC]().", + "enum": [ + "VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/groups", + "response": { + "$ref": "ListGroupsResponse" + } + }, + "lookup": { + "description": "Looks up [resource\nname](https://cloud.google.com/apis/design/resource_names) of a Group by\nits EntityKey.", + "flatPath": "v1/groups:lookup", + "httpMethod": "GET", + "id": "cloudidentity.groups.lookup", + "parameterOrder": [], + "parameters": { + "groupKey.id": { + "description": "The ID of the entity within the given namespace. The ID must be unique\nwithin its namespace.", + "location": "query", + "type": "string" + }, + "groupKey.namespace": { + "description": "Namespaces provide isolation for IDs, so an ID only needs to be unique\nwithin its namespace.\n\nNamespaces are currently only created as part of IdentitySource creation\nfrom Admin Console. A namespace `\"identitysources/{identity_source_id}\"` is\ncreated corresponding to every Identity Source `identity_source_id`.", + "location": "query", + "type": "string" + } + }, + "path": "v1/groups:lookup", + "response": { + "$ref": "LookupGroupNameResponse" + } + }, + "patch": { + "description": "Updates a Group.", + "flatPath": "v1/groups/{groupsId}", + "httpMethod": "PATCH", + "id": "cloudidentity.groups.patch", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where group_id is the unique ID\nassigned to the Group.\n\nMust be left blank while creating a Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Editable fields: `display_name`, `description`", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "v1/{+name}", + "request": { + "$ref": "Group" + }, + "response": { + "$ref": "Operation" + } + }, + "search": { + "description": "Searches for Groups.", + "flatPath": "v1/groups:search", + "httpMethod": "GET", + "id": "cloudidentity.groups.search", + "parameterOrder": [], + "parameters": { + "pageSize": { + "description": "Maximum number of Groups to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The next_page_token value returned from a previous search request, if any.", + "location": "query", + "type": "string" + }, + "query": { + "description": "`Required`. Query string for performing search on groups. Users can search\non parent and label attributes of groups.\nEXACT match ('==') is supported on parent, and CONTAINS match ('in') is\nsupported on labels.", + "location": "query", + "type": "string" + }, + "view": { + "description": "Group resource view to be returned. Defaults to [View.BASIC]().", + "enum": [ + "VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/groups:search", + "response": { + "$ref": "SearchGroupsResponse" + } + } + }, + "resources": { + "memberships": { + "methods": { + "create": { + "description": "Creates a Membership.", + "flatPath": "v1/groups/{groupsId}/memberships", + "httpMethod": "POST", + "id": "cloudidentity.groups.memberships.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to create Membership within. Format: `groups/{group_id}`, where\n`group_id` is the unique ID assigned to the Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/memberships", + "request": { + "$ref": "Membership" + }, + "response": { + "$ref": "Operation" + } + }, + "delete": { + "description": "Deletes a Membership.", + "flatPath": "v1/groups/{groupsId}/memberships/{membershipsId}", + "httpMethod": "DELETE", + "id": "cloudidentity.groups.memberships.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership to be deleted.\n\nFormat: `groups/{group_id}/memberships/{member_id}`, where `group_id` is\nthe unique ID assigned to the Group to which Membership belongs to, and\nmember_id is the unique ID assigned to the member.", + "location": "path", + "pattern": "^groups/[^/]+/memberships/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Operation" + } + }, + "get": { + "description": "Retrieves a Membership.", + "flatPath": "v1/groups/{groupsId}/memberships/{membershipsId}", + "httpMethod": "GET", + "id": "cloudidentity.groups.memberships.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership to be retrieved.\n\nFormat: `groups/{group_id}/memberships/{member_id}`, where `group_id` is\nthe unique id assigned to the Group to which Membership belongs to, and\n`member_id` is the unique ID assigned to the member.", + "location": "path", + "pattern": "^groups/[^/]+/memberships/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+name}", + "response": { + "$ref": "Membership" + } + }, + "list": { + "description": "List Memberships within a Group.", + "flatPath": "v1/groups/{groupsId}/memberships", + "httpMethod": "GET", + "id": "cloudidentity.groups.memberships.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Maximum number of Memberships to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "The next_page_token value returned from a previous list request, if any.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to list Memberships within.\n\nFormat: `groups/{group_id}`, where `group_id` is the unique ID assigned to\nthe Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + }, + "view": { + "description": "Membership resource view to be returned. Defaults to View.BASIC.", + "enum": [ + "VIEW_UNSPECIFIED", + "BASIC", + "FULL" + ], + "location": "query", + "type": "string" + } + }, + "path": "v1/{+parent}/memberships", + "response": { + "$ref": "ListMembershipsResponse" + } + }, + "lookup": { + "description": "Looks up [resource\nname](https://cloud.google.com/apis/design/resource_names) of a Membership\nwithin a Group by member's EntityKey.", + "flatPath": "v1/groups/{groupsId}/memberships:lookup", + "httpMethod": "GET", + "id": "cloudidentity.groups.memberships.lookup", + "parameterOrder": [ + "parent" + ], + "parameters": { + "memberKey.id": { + "description": "The ID of the entity within the given namespace. The ID must be unique\nwithin its namespace.", + "location": "query", + "type": "string" + }, + "memberKey.namespace": { + "description": "Namespaces provide isolation for IDs, so an ID only needs to be unique\nwithin its namespace.\n\nNamespaces are currently only created as part of IdentitySource creation\nfrom Admin Console. A namespace `\"identitysources/{identity_source_id}\"` is\ncreated corresponding to every Identity Source `identity_source_id`.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to lookup Membership within.\n\nFormat: `groups/{group_id}`, where `group_id` is the unique ID assigned to\nthe Group.", + "location": "path", + "pattern": "^groups/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+parent}/memberships:lookup", + "response": { + "$ref": "LookupMembershipNameResponse" + } + } + } + } + } + } + }, + "revision": "20181218", + "rootUrl": "https://cloudidentity.googleapis.com/", + "schemas": { + "EntityKey": { + "description": "An EntityKey uniquely identifies an Entity. Namespaces are used to provide\nisolation for IDs. A single ID can be reused across namespaces but the\ncombination of a namespace and an ID must be unique.", + "id": "EntityKey", + "properties": { + "id": { + "description": "The ID of the entity within the given namespace. The ID must be unique\nwithin its namespace.", + "type": "string" + }, + "namespace": { + "description": "Namespaces provide isolation for IDs, so an ID only needs to be unique\nwithin its namespace.\n\nNamespaces are currently only created as part of IdentitySource creation\nfrom Admin Console. A namespace `\"identitysources/{identity_source_id}\"` is\ncreated corresponding to every Identity Source `identity_source_id`.", + "type": "string" + } + }, + "type": "object" + }, + "Group": { + "description": "Resource representing a Group.", + "id": "Group", + "properties": { + "createTime": { + "description": "The time when the Group was created.\nOutput only.", + "format": "google-datetime", + "type": "string" + }, + "description": { + "description": "An extended description to help users determine the purpose of a Group. For\nexample, you can include information about who should join the Group, the\ntypes of messages to send to the Group, links to FAQs about the Group, or\nrelated Groups. Maximum length is 4,096 characters.", + "type": "string" + }, + "displayName": { + "description": "The Group's display name.", + "type": "string" + }, + "groupKey": { + "$ref": "EntityKey", + "description": "EntityKey of the Group.\n\nMust be set when creating a Group, read-only afterwards." + }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "`Required`. Labels for Group resource.\nFor creating Groups under a namespace, set label key to\n'labels/system/groups/external' and label value as empty.", + "type": "object" + }, + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where group_id is the unique ID\nassigned to the Group.\n\nMust be left blank while creating a Group.", + "type": "string" + }, + "parent": { + "description": "The entity under which this Group resides in Cloud Identity resource\nhierarchy. Must be set when creating a Group, read-only afterwards.\n\nCurrently allowed types: `identitysources`.", + "type": "string" + }, + "updateTime": { + "description": "The time when the Group was last updated.\nOutput only.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "ListGroupsResponse": { + "description": "Response message for ListGroups operation.", + "id": "ListGroupsResponse", + "properties": { + "groups": { + "description": "Groups returned in response to list request.\nThe results are not sorted.", + "items": { + "$ref": "Group" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no\nmore results available for listing.", + "type": "string" + } + }, + "type": "object" + }, + "ListMembershipsResponse": { + "id": "ListMembershipsResponse", + "properties": { + "memberships": { + "description": "List of Memberships.", + "items": { + "$ref": "Membership" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no\nmore results available for listing.", + "type": "string" + } + }, + "type": "object" + }, + "LookupGroupNameResponse": { + "id": "LookupGroupNameResponse", + "properties": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where `group_id` is the unique ID\nassigned to the Group.", + "type": "string" + } + }, + "type": "object" + }, + "LookupMembershipNameResponse": { + "id": "LookupMembershipNameResponse", + "properties": { + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership being looked up.\n\nFormat: `groups/{group_id}/memberships/{member_id}`, where `group_id` is\nthe unique ID assigned to the Group to which Membership belongs to, and\n`member_id` is the unique ID assigned to the member.", + "type": "string" + } + }, + "type": "object" + }, + "Membership": { + "description": "Resource representing a Membership within a Group", + "id": "Membership", + "properties": { + "createTime": { + "description": "Creation timestamp of the Membership. Output only.", + "format": "google-datetime", + "type": "string" + }, + "name": { + "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership in the format: `groups/{group_id}/memberships/{member_id}`, where\ngroup_id is the unique ID assigned to the Group to which Membership belongs\nto, and member_id is the unique ID assigned to the member\n\nMust be left blank while creating a Membership.", + "type": "string" + }, + "preferredMemberKey": { + "$ref": "EntityKey", + "description": "EntityKey of the entity to be added as the member. Must be set while\ncreating a Membership, read-only afterwards.\n\nCurrently allowed entity types: `Users`, `Groups`." + }, + "roles": { + "description": "Roles for a member within the Group.\n\nCurrently supported MembershipRoles: `\"MEMBER\"`.", + "items": { + "$ref": "MembershipRole" + }, + "type": "array" + }, + "updateTime": { + "description": "Last updated timestamp of the Membership. Output only.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "MembershipRole": { + "description": "Resource representing a role within a Membership.", + "id": "MembershipRole", + "properties": { + "name": { + "description": "MembershipRole in string format.\n\nCurrently supported MembershipRoles: `\"MEMBER\"`.", + "type": "string" + } + }, + "type": "object" + }, + "Operation": { + "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.", + "id": "Operation", + "properties": { + "done": { + "description": "If the value is `false`, it means the operation is still in progress.\nIf `true`, the operation is completed, and either `error` or `response` is\navailable.", + "type": "boolean" + }, + "error": { + "$ref": "Status", + "description": "The error result of the operation in case of failure or cancellation." + }, + "metadata": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "Service-specific metadata associated with the operation. It typically\ncontains progress information and common metadata such as create time.\nSome services might not provide such metadata. Any method that returns a\nlong-running operation should document the metadata type, if any.", + "type": "object" + }, + "name": { + "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should have the format of `operations/some/unique/name`.", + "type": "string" + }, + "response": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.", + "type": "object" + } + }, + "type": "object" + }, + "SearchGroupsResponse": { + "id": "SearchGroupsResponse", + "properties": { + "groups": { + "description": "List of Groups satisfying the search query.", + "items": { + "$ref": "Group" + }, + "type": "array" + }, + "nextPageToken": { + "description": "Token to retrieve the next page of results, or empty if there are no\nmore results available for specified query.", + "type": "string" + } + }, + "type": "object" + }, + "Status": { + "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RPC APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error message,\nand error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.", + "id": "Status", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "format": "int32", + "type": "integer" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.", + "items": { + "additionalProperties": { + "description": "Properties of the object. Contains field @type with type URL.", + "type": "any" + }, + "type": "object" + }, + "type": "array" + }, + "message": { + "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.", + "type": "string" + } + }, + "type": "object" + } + }, + "servicePath": "", + "title": "Cloud Identity API", + "version": "v1", + "version_module": true +} \ No newline at end of file diff --git a/cloudidentity/v1/cloudidentity-gen.go b/cloudidentity/v1/cloudidentity-gen.go new file mode 100644 index 00000000000..e4c988d2e8d --- /dev/null +++ b/cloudidentity/v1/cloudidentity-gen.go @@ -0,0 +1,2607 @@ +// Copyright 2018 Google Inc. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +// Code generated file. DO NOT EDIT. + +// Package cloudidentity provides access to the Cloud Identity API. +// +// See https://cloud.google.com/identity/ +// +// Usage example: +// +// import "google.golang.org/api/cloudidentity/v1" +// ... +// cloudidentityService, err := cloudidentity.New(oauthHttpClient) +package cloudidentity // import "google.golang.org/api/cloudidentity/v1" + +import ( + "bytes" + "context" + "encoding/json" + "errors" + "fmt" + "io" + "net/http" + "net/url" + "strconv" + "strings" + + gensupport "google.golang.org/api/gensupport" + googleapi "google.golang.org/api/googleapi" +) + +// Always reference these packages, just in case the auto-generated code +// below doesn't. +var _ = bytes.NewBuffer +var _ = strconv.Itoa +var _ = fmt.Sprintf +var _ = json.NewDecoder +var _ = io.Copy +var _ = url.Parse +var _ = gensupport.MarshalJSON +var _ = googleapi.Version +var _ = errors.New +var _ = strings.Replace +var _ = context.Canceled + +const apiId = "cloudidentity:v1" +const apiName = "cloudidentity" +const apiVersion = "v1" +const basePath = "https://cloudidentity.googleapis.com/" + +func New(client *http.Client) (*Service, error) { + if client == nil { + return nil, errors.New("client is nil") + } + s := &Service{client: client, BasePath: basePath} + s.Groups = NewGroupsService(s) + return s, nil +} + +type Service struct { + client *http.Client + BasePath string // API endpoint base URL + UserAgent string // optional additional User-Agent fragment + + Groups *GroupsService +} + +func (s *Service) userAgent() string { + if s.UserAgent == "" { + return googleapi.UserAgent + } + return googleapi.UserAgent + " " + s.UserAgent +} + +func NewGroupsService(s *Service) *GroupsService { + rs := &GroupsService{s: s} + rs.Memberships = NewGroupsMembershipsService(s) + return rs +} + +type GroupsService struct { + s *Service + + Memberships *GroupsMembershipsService +} + +func NewGroupsMembershipsService(s *Service) *GroupsMembershipsService { + rs := &GroupsMembershipsService{s: s} + return rs +} + +type GroupsMembershipsService struct { + s *Service +} + +// EntityKey: An EntityKey uniquely identifies an Entity. Namespaces are +// used to provide +// isolation for IDs. A single ID can be reused across namespaces but +// the +// combination of a namespace and an ID must be unique. +type EntityKey struct { + // Id: The ID of the entity within the given namespace. The ID must be + // unique + // within its namespace. + Id string `json:"id,omitempty"` + + // Namespace: Namespaces provide isolation for IDs, so an ID only needs + // to be unique + // within its namespace. + // + // Namespaces are currently only created as part of IdentitySource + // creation + // from Admin Console. A namespace + // "identitysources/{identity_source_id}" is + // created corresponding to every Identity Source `identity_source_id`. + Namespace string `json:"namespace,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Id") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Id") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *EntityKey) MarshalJSON() ([]byte, error) { + type NoMethod EntityKey + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Group: Resource representing a Group. +type Group struct { + // CreateTime: The time when the Group was created. + // Output only. + CreateTime string `json:"createTime,omitempty"` + + // Description: An extended description to help users determine the + // purpose of a Group. For + // example, you can include information about who should join the Group, + // the + // types of messages to send to the Group, links to FAQs about the + // Group, or + // related Groups. Maximum length is 4,096 characters. + Description string `json:"description,omitempty"` + + // DisplayName: The Group's display name. + DisplayName string `json:"displayName,omitempty"` + + // GroupKey: EntityKey of the Group. + // + // Must be set when creating a Group, read-only afterwards. + GroupKey *EntityKey `json:"groupKey,omitempty"` + + // Labels: `Required`. Labels for Group resource. + // For creating Groups under a namespace, set label key + // to + // 'labels/system/groups/external' and label value as empty. + Labels map[string]string `json:"labels,omitempty"` + + // Name: [Resource + // name](https://cloud.google.com/apis/design/resource_names) of + // the + // Group in the format: `groups/{group_id}`, where group_id is the + // unique ID + // assigned to the Group. + // + // Must be left blank while creating a Group. + Name string `json:"name,omitempty"` + + // Parent: The entity under which this Group resides in Cloud Identity + // resource + // hierarchy. Must be set when creating a Group, read-only + // afterwards. + // + // Currently allowed types: `identitysources`. + Parent string `json:"parent,omitempty"` + + // UpdateTime: The time when the Group was last updated. + // Output only. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Group) MarshalJSON() ([]byte, error) { + type NoMethod Group + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// ListGroupsResponse: Response message for ListGroups operation. +type ListGroupsResponse struct { + // Groups: Groups returned in response to list request. + // The results are not sorted. + Groups []*Group `json:"groups,omitempty"` + + // NextPageToken: Token to retrieve the next page of results, or empty + // if there are no + // more results available for listing. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Groups") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Groups") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListGroupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListGroupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type ListMembershipsResponse struct { + // Memberships: List of Memberships. + Memberships []*Membership `json:"memberships,omitempty"` + + // NextPageToken: Token to retrieve the next page of results, or empty + // if there are no + // more results available for listing. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Memberships") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Memberships") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *ListMembershipsResponse) MarshalJSON() ([]byte, error) { + type NoMethod ListMembershipsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type LookupGroupNameResponse struct { + // Name: [Resource + // name](https://cloud.google.com/apis/design/resource_names) of + // the + // Group in the format: `groups/{group_id}`, where `group_id` is the + // unique ID + // assigned to the Group. + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *LookupGroupNameResponse) MarshalJSON() ([]byte, error) { + type NoMethod LookupGroupNameResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type LookupMembershipNameResponse struct { + // Name: [Resource + // name](https://cloud.google.com/apis/design/resource_names) of + // the + // Membership being looked up. + // + // Format: `groups/{group_id}/memberships/{member_id}`, where `group_id` + // is + // the unique ID assigned to the Group to which Membership belongs to, + // and + // `member_id` is the unique ID assigned to the member. + Name string `json:"name,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *LookupMembershipNameResponse) MarshalJSON() ([]byte, error) { + type NoMethod LookupMembershipNameResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Membership: Resource representing a Membership within a Group +type Membership struct { + // CreateTime: Creation timestamp of the Membership. Output only. + CreateTime string `json:"createTime,omitempty"` + + // Name: [Resource + // name](https://cloud.google.com/apis/design/resource_names) of + // the + // Membership in the format: + // `groups/{group_id}/memberships/{member_id}`, where + // group_id is the unique ID assigned to the Group to which Membership + // belongs + // to, and member_id is the unique ID assigned to the member + // + // Must be left blank while creating a Membership. + Name string `json:"name,omitempty"` + + // PreferredMemberKey: EntityKey of the entity to be added as the + // member. Must be set while + // creating a Membership, read-only afterwards. + // + // Currently allowed entity types: `Users`, `Groups`. + PreferredMemberKey *EntityKey `json:"preferredMemberKey,omitempty"` + + // Roles: Roles for a member within the Group. + // + // Currently supported MembershipRoles: "MEMBER". + Roles []*MembershipRole `json:"roles,omitempty"` + + // UpdateTime: Last updated timestamp of the Membership. Output only. + UpdateTime string `json:"updateTime,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "CreateTime") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "CreateTime") to include in + // API requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Membership) MarshalJSON() ([]byte, error) { + type NoMethod Membership + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// MembershipRole: Resource representing a role within a Membership. +type MembershipRole struct { + // Name: MembershipRole in string format. + // + // Currently supported MembershipRoles: "MEMBER". + Name string `json:"name,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Name") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Name") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *MembershipRole) MarshalJSON() ([]byte, error) { + type NoMethod MembershipRole + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Operation: This resource represents a long-running operation that is +// the result of a +// network API call. +type Operation struct { + // Done: If the value is `false`, it means the operation is still in + // progress. + // If `true`, the operation is completed, and either `error` or + // `response` is + // available. + Done bool `json:"done,omitempty"` + + // Error: The error result of the operation in case of failure or + // cancellation. + Error *Status `json:"error,omitempty"` + + // Metadata: Service-specific metadata associated with the operation. + // It typically + // contains progress information and common metadata such as create + // time. + // Some services might not provide such metadata. Any method that + // returns a + // long-running operation should document the metadata type, if any. + Metadata googleapi.RawMessage `json:"metadata,omitempty"` + + // Name: The server-assigned name, which is only unique within the same + // service that + // originally returns it. If you use the default HTTP mapping, + // the + // `name` should have the format of `operations/some/unique/name`. + Name string `json:"name,omitempty"` + + // Response: The normal response of the operation in case of success. + // If the original + // method returns no data on success, such as `Delete`, the response + // is + // `google.protobuf.Empty`. If the original method is + // standard + // `Get`/`Create`/`Update`, the response should be the resource. For + // other + // methods, the response should have the type `XxxResponse`, where + // `Xxx` + // is the original method name. For example, if the original method + // name + // is `TakeSnapshot()`, the inferred response type + // is + // `TakeSnapshotResponse`. + Response googleapi.RawMessage `json:"response,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Done") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Done") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Operation) MarshalJSON() ([]byte, error) { + type NoMethod Operation + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +type SearchGroupsResponse struct { + // Groups: List of Groups satisfying the search query. + Groups []*Group `json:"groups,omitempty"` + + // NextPageToken: Token to retrieve the next page of results, or empty + // if there are no + // more results available for specified query. + NextPageToken string `json:"nextPageToken,omitempty"` + + // ServerResponse contains the HTTP response code and headers from the + // server. + googleapi.ServerResponse `json:"-"` + + // ForceSendFields is a list of field names (e.g. "Groups") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Groups") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *SearchGroupsResponse) MarshalJSON() ([]byte, error) { + type NoMethod SearchGroupsResponse + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// Status: The `Status` type defines a logical error model that is +// suitable for different +// programming environments, including REST APIs and RPC APIs. It is +// used by +// [gRPC](https://github.com/grpc). The error model is designed to +// be: +// +// - Simple to use and understand for most users +// - Flexible enough to meet unexpected needs +// +// # Overview +// +// The `Status` message contains three pieces of data: error code, error +// message, +// and error details. The error code should be an enum value +// of +// google.rpc.Code, but it may accept additional error codes if needed. +// The +// error message should be a developer-facing English message that +// helps +// developers *understand* and *resolve* the error. If a localized +// user-facing +// error message is needed, put the localized message in the error +// details or +// localize it in the client. The optional error details may contain +// arbitrary +// information about the error. There is a predefined set of error +// detail types +// in the package `google.rpc` that can be used for common error +// conditions. +// +// # Language mapping +// +// The `Status` message is the logical representation of the error +// model, but it +// is not necessarily the actual wire format. When the `Status` message +// is +// exposed in different client libraries and different wire protocols, +// it can be +// mapped differently. For example, it will likely be mapped to some +// exceptions +// in Java, but more likely mapped to some error codes in C. +// +// # Other uses +// +// The error model and the `Status` message can be used in a variety +// of +// environments, either with or without APIs, to provide a +// consistent developer experience across different +// environments. +// +// Example uses of this error model include: +// +// - Partial errors. If a service needs to return partial errors to the +// client, +// it may embed the `Status` in the normal response to indicate the +// partial +// errors. +// +// - Workflow errors. A typical workflow has multiple steps. Each step +// may +// have a `Status` message for error reporting. +// +// - Batch operations. If a client uses batch request and batch +// response, the +// `Status` message should be used directly inside batch response, +// one for +// each error sub-response. +// +// - Asynchronous operations. If an API call embeds asynchronous +// operation +// results in its response, the status of those operations should +// be +// represented directly using the `Status` message. +// +// - Logging. If some API errors are stored in logs, the message +// `Status` could +// be used directly after any stripping needed for security/privacy +// reasons. +type Status struct { + // Code: The status code, which should be an enum value of + // google.rpc.Code. + Code int64 `json:"code,omitempty"` + + // Details: A list of messages that carry the error details. There is a + // common set of + // message types for APIs to use. + Details []googleapi.RawMessage `json:"details,omitempty"` + + // Message: A developer-facing error message, which should be in + // English. Any + // user-facing error message should be localized and sent in + // the + // google.rpc.Status.details field, or localized by the client. + Message string `json:"message,omitempty"` + + // ForceSendFields is a list of field names (e.g. "Code") to + // unconditionally include in API requests. By default, fields with + // empty values are omitted from API requests. However, any non-pointer, + // non-interface field appearing in ForceSendFields will be sent to the + // server regardless of whether the field is empty or not. This may be + // used to include empty fields in Patch requests. + ForceSendFields []string `json:"-"` + + // NullFields is a list of field names (e.g. "Code") to include in API + // requests with the JSON null value. By default, fields with empty + // values are omitted from API requests. However, any field with an + // empty value appearing in NullFields will be sent to the server as + // null. It is an error if a field in this list has a non-empty value. + // This may be used to include null fields in Patch requests. + NullFields []string `json:"-"` +} + +func (s *Status) MarshalJSON() ([]byte, error) { + type NoMethod Status + raw := NoMethod(*s) + return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) +} + +// method id "cloudidentity.groups.create": + +type GroupsCreateCall struct { + s *Service + group *Group + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a Group. +func (r *GroupsService) Create(group *Group) *GroupsCreateCall { + c := &GroupsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.group = group + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsCreateCall) Fields(s ...googleapi.Field) *GroupsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsCreateCall) Context(ctx context.Context) *GroupsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.group) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/groups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.create" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a Group.", + // "flatPath": "v1/groups", + // "httpMethod": "POST", + // "id": "cloudidentity.groups.create", + // "parameterOrder": [], + // "parameters": {}, + // "path": "v1/groups", + // "request": { + // "$ref": "Group" + // }, + // "response": { + // "$ref": "Operation" + // } + // } + +} + +// method id "cloudidentity.groups.delete": + +type GroupsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a Group. +func (r *GroupsService) Delete(name string) *GroupsDeleteCall { + c := &GroupsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsDeleteCall) Fields(s ...googleapi.Field) *GroupsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsDeleteCall) Context(ctx context.Context) *GroupsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.delete" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a Group.", + // "flatPath": "v1/groups/{groupsId}", + // "httpMethod": "DELETE", + // "id": "cloudidentity.groups.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where `group_id` is the unique ID\nassigned to the Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // } + // } + +} + +// method id "cloudidentity.groups.get": + +type GroupsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a Group. +func (r *GroupsService) Get(name string) *GroupsGetCall { + c := &GroupsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsGetCall) Fields(s ...googleapi.Field) *GroupsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsGetCall) IfNoneMatch(entityTag string) *GroupsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsGetCall) Context(ctx context.Context) *GroupsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.get" call. +// Exactly one of *Group or error will be non-nil. Any non-2xx status +// code is an error. Response headers are in either +// *Group.ServerResponse.Header or (if a response was returned at all) +// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to +// check whether the returned error was because http.StatusNotModified +// was returned. +func (c *GroupsGetCall) Do(opts ...googleapi.CallOption) (*Group, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Group{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Retrieves a Group.", + // "flatPath": "v1/groups/{groupsId}", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where `group_id` is the unique ID\nassigned to the Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Group" + // } + // } + +} + +// method id "cloudidentity.groups.list": + +type GroupsListCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List groups within a customer or a domain. +func (r *GroupsService) List() *GroupsListCall { + c := &GroupsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// Groups to return. +// +// View | Default | Maximum +// -----|---------|-------- +// BASIC | 200 | 1000 +// FULL | 50 | 500 +func (c *GroupsListCall) PageSize(pageSize int64) *GroupsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The +// next_page_token value returned from a previous list request, if any. +func (c *GroupsListCall) PageToken(pageToken string) *GroupsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Parent sets the optional parameter "parent": `Required`. May be made +// Optional in the future. +// Customer ID to list all groups from. +func (c *GroupsListCall) Parent(parent string) *GroupsListCall { + c.urlParams_.Set("parent", parent) + return c +} + +// View sets the optional parameter "view": Group resource view to be +// returned. Defaults to [View.BASIC](). +// +// Possible values: +// "VIEW_UNSPECIFIED" +// "BASIC" +// "FULL" +func (c *GroupsListCall) View(view string) *GroupsListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsListCall) Fields(s ...googleapi.Field) *GroupsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsListCall) IfNoneMatch(entityTag string) *GroupsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsListCall) Context(ctx context.Context) *GroupsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/groups") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.list" call. +// Exactly one of *ListGroupsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListGroupsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *GroupsListCall) Do(opts ...googleapi.CallOption) (*ListGroupsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &ListGroupsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "List groups within a customer or a domain.", + // "flatPath": "v1/groups", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.list", + // "parameterOrder": [], + // "parameters": { + // "pageSize": { + // "description": "Maximum number of Groups to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The next_page_token value returned from a previous list request, if any.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "`Required`. May be made Optional in the future.\nCustomer ID to list all groups from.", + // "location": "query", + // "type": "string" + // }, + // "view": { + // "description": "Group resource view to be returned. Defaults to [View.BASIC]().", + // "enum": [ + // "VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/groups", + // "response": { + // "$ref": "ListGroupsResponse" + // } + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *GroupsListCall) Pages(ctx context.Context, f func(*ListGroupsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +// method id "cloudidentity.groups.lookup": + +type GroupsLookupCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Lookup: Looks up +// [resource +// name](https://cloud.google.com/apis/design/resource_names) of a Group +// by +// its EntityKey. +func (r *GroupsService) Lookup() *GroupsLookupCall { + c := &GroupsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} + return c +} + +// GroupKeyId sets the optional parameter "groupKey.id": The ID of the +// entity within the given namespace. The ID must be unique +// within its namespace. +func (c *GroupsLookupCall) GroupKeyId(groupKeyId string) *GroupsLookupCall { + c.urlParams_.Set("groupKey.id", groupKeyId) + return c +} + +// GroupKeyNamespace sets the optional parameter "groupKey.namespace": +// Namespaces provide isolation for IDs, so an ID only needs to be +// unique +// within its namespace. +// +// Namespaces are currently only created as part of IdentitySource +// creation +// from Admin Console. A namespace +// "identitysources/{identity_source_id}" is +// created corresponding to every Identity Source `identity_source_id`. +func (c *GroupsLookupCall) GroupKeyNamespace(groupKeyNamespace string) *GroupsLookupCall { + c.urlParams_.Set("groupKey.namespace", groupKeyNamespace) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsLookupCall) Fields(s ...googleapi.Field) *GroupsLookupCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsLookupCall) IfNoneMatch(entityTag string) *GroupsLookupCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsLookupCall) Context(ctx context.Context) *GroupsLookupCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsLookupCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsLookupCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/groups:lookup") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.lookup" call. +// Exactly one of *LookupGroupNameResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *LookupGroupNameResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *GroupsLookupCall) Do(opts ...googleapi.CallOption) (*LookupGroupNameResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &LookupGroupNameResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Looks up [resource\nname](https://cloud.google.com/apis/design/resource_names) of a Group by\nits EntityKey.", + // "flatPath": "v1/groups:lookup", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.lookup", + // "parameterOrder": [], + // "parameters": { + // "groupKey.id": { + // "description": "The ID of the entity within the given namespace. The ID must be unique\nwithin its namespace.", + // "location": "query", + // "type": "string" + // }, + // "groupKey.namespace": { + // "description": "Namespaces provide isolation for IDs, so an ID only needs to be unique\nwithin its namespace.\n\nNamespaces are currently only created as part of IdentitySource creation\nfrom Admin Console. A namespace `\"identitysources/{identity_source_id}\"` is\ncreated corresponding to every Identity Source `identity_source_id`.", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/groups:lookup", + // "response": { + // "$ref": "LookupGroupNameResponse" + // } + // } + +} + +// method id "cloudidentity.groups.patch": + +type GroupsPatchCall struct { + s *Service + name string + group *Group + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Patch: Updates a Group. +func (r *GroupsService) Patch(name string, group *Group) *GroupsPatchCall { + c := &GroupsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + c.group = group + return c +} + +// UpdateMask sets the optional parameter "updateMask": Editable fields: +// `display_name`, `description` +func (c *GroupsPatchCall) UpdateMask(updateMask string) *GroupsPatchCall { + c.urlParams_.Set("updateMask", updateMask) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsPatchCall) Fields(s ...googleapi.Field) *GroupsPatchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsPatchCall) Context(ctx context.Context) *GroupsPatchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsPatchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsPatchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.group) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("PATCH", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.patch" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Updates a Group.", + // "flatPath": "v1/groups/{groupsId}", + // "httpMethod": "PATCH", + // "id": "cloudidentity.groups.patch", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup in the format: `groups/{group_id}`, where group_id is the unique ID\nassigned to the Group.\n\nMust be left blank while creating a Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "updateMask": { + // "description": "Editable fields: `display_name`, `description`", + // "format": "google-fieldmask", + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "request": { + // "$ref": "Group" + // }, + // "response": { + // "$ref": "Operation" + // } + // } + +} + +// method id "cloudidentity.groups.search": + +type GroupsSearchCall struct { + s *Service + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Search: Searches for Groups. +func (r *GroupsService) Search() *GroupsSearchCall { + c := &GroupsSearchCall{s: r.s, urlParams_: make(gensupport.URLParams)} + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// Groups to return. +// +// View | Default | Maximum +// -----|---------|-------- +// BASIC | 200 | 1000 +// FULL | 50 | 500 +func (c *GroupsSearchCall) PageSize(pageSize int64) *GroupsSearchCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The +// next_page_token value returned from a previous search request, if +// any. +func (c *GroupsSearchCall) PageToken(pageToken string) *GroupsSearchCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// Query sets the optional parameter "query": `Required`. Query string +// for performing search on groups. Users can search +// on parent and label attributes of groups. +// EXACT match ('==') is supported on parent, and CONTAINS match ('in') +// is +// supported on labels. +func (c *GroupsSearchCall) Query(query string) *GroupsSearchCall { + c.urlParams_.Set("query", query) + return c +} + +// View sets the optional parameter "view": Group resource view to be +// returned. Defaults to [View.BASIC](). +// +// Possible values: +// "VIEW_UNSPECIFIED" +// "BASIC" +// "FULL" +func (c *GroupsSearchCall) View(view string) *GroupsSearchCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsSearchCall) Fields(s ...googleapi.Field) *GroupsSearchCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsSearchCall) IfNoneMatch(entityTag string) *GroupsSearchCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsSearchCall) Context(ctx context.Context) *GroupsSearchCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsSearchCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsSearchCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/groups:search") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.search" call. +// Exactly one of *SearchGroupsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *SearchGroupsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *GroupsSearchCall) Do(opts ...googleapi.CallOption) (*SearchGroupsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &SearchGroupsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Searches for Groups.", + // "flatPath": "v1/groups:search", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.search", + // "parameterOrder": [], + // "parameters": { + // "pageSize": { + // "description": "Maximum number of Groups to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The next_page_token value returned from a previous search request, if any.", + // "location": "query", + // "type": "string" + // }, + // "query": { + // "description": "`Required`. Query string for performing search on groups. Users can search\non parent and label attributes of groups.\nEXACT match ('==') is supported on parent, and CONTAINS match ('in') is\nsupported on labels.", + // "location": "query", + // "type": "string" + // }, + // "view": { + // "description": "Group resource view to be returned. Defaults to [View.BASIC]().", + // "enum": [ + // "VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/groups:search", + // "response": { + // "$ref": "SearchGroupsResponse" + // } + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *GroupsSearchCall) Pages(ctx context.Context, f func(*SearchGroupsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +// method id "cloudidentity.groups.memberships.create": + +type GroupsMembershipsCreateCall struct { + s *Service + parent string + membership *Membership + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Create: Creates a Membership. +func (r *GroupsMembershipsService) Create(parent string, membership *Membership) *GroupsMembershipsCreateCall { + c := &GroupsMembershipsCreateCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + c.membership = membership + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsMembershipsCreateCall) Fields(s ...googleapi.Field) *GroupsMembershipsCreateCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsMembershipsCreateCall) Context(ctx context.Context) *GroupsMembershipsCreateCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsMembershipsCreateCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsMembershipsCreateCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + body, err := googleapi.WithoutDataWrapper.JSONReader(c.membership) + if err != nil { + return nil, err + } + reqHeaders.Set("Content-Type", "application/json") + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/memberships") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("POST", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.memberships.create" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsMembershipsCreateCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Creates a Membership.", + // "flatPath": "v1/groups/{groupsId}/memberships", + // "httpMethod": "POST", + // "id": "cloudidentity.groups.memberships.create", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "parent": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to create Membership within. Format: `groups/{group_id}`, where\n`group_id` is the unique ID assigned to the Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/memberships", + // "request": { + // "$ref": "Membership" + // }, + // "response": { + // "$ref": "Operation" + // } + // } + +} + +// method id "cloudidentity.groups.memberships.delete": + +type GroupsMembershipsDeleteCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ctx_ context.Context + header_ http.Header +} + +// Delete: Deletes a Membership. +func (r *GroupsMembershipsService) Delete(name string) *GroupsMembershipsDeleteCall { + c := &GroupsMembershipsDeleteCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsMembershipsDeleteCall) Fields(s ...googleapi.Field) *GroupsMembershipsDeleteCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsMembershipsDeleteCall) Context(ctx context.Context) *GroupsMembershipsDeleteCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsMembershipsDeleteCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsMembershipsDeleteCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("DELETE", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.memberships.delete" call. +// Exactly one of *Operation or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Operation.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsMembershipsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Operation{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Deletes a Membership.", + // "flatPath": "v1/groups/{groupsId}/memberships/{membershipsId}", + // "httpMethod": "DELETE", + // "id": "cloudidentity.groups.memberships.delete", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership to be deleted.\n\nFormat: `groups/{group_id}/memberships/{member_id}`, where `group_id` is\nthe unique ID assigned to the Group to which Membership belongs to, and\nmember_id is the unique ID assigned to the member.", + // "location": "path", + // "pattern": "^groups/[^/]+/memberships/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Operation" + // } + // } + +} + +// method id "cloudidentity.groups.memberships.get": + +type GroupsMembershipsGetCall struct { + s *Service + name string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Get: Retrieves a Membership. +func (r *GroupsMembershipsService) Get(name string) *GroupsMembershipsGetCall { + c := &GroupsMembershipsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.name = name + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsMembershipsGetCall) Fields(s ...googleapi.Field) *GroupsMembershipsGetCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsMembershipsGetCall) IfNoneMatch(entityTag string) *GroupsMembershipsGetCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsMembershipsGetCall) Context(ctx context.Context) *GroupsMembershipsGetCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsMembershipsGetCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsMembershipsGetCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "name": c.name, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.memberships.get" call. +// Exactly one of *Membership or error will be non-nil. Any non-2xx +// status code is an error. Response headers are in either +// *Membership.ServerResponse.Header or (if a response was returned at +// all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified +// to check whether the returned error was because +// http.StatusNotModified was returned. +func (c *GroupsMembershipsGetCall) Do(opts ...googleapi.CallOption) (*Membership, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &Membership{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Retrieves a Membership.", + // "flatPath": "v1/groups/{groupsId}/memberships/{membershipsId}", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.memberships.get", + // "parameterOrder": [ + // "name" + // ], + // "parameters": { + // "name": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nMembership to be retrieved.\n\nFormat: `groups/{group_id}/memberships/{member_id}`, where `group_id` is\nthe unique id assigned to the Group to which Membership belongs to, and\n`member_id` is the unique ID assigned to the member.", + // "location": "path", + // "pattern": "^groups/[^/]+/memberships/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+name}", + // "response": { + // "$ref": "Membership" + // } + // } + +} + +// method id "cloudidentity.groups.memberships.list": + +type GroupsMembershipsListCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// List: List Memberships within a Group. +func (r *GroupsMembershipsService) List(parent string) *GroupsMembershipsListCall { + c := &GroupsMembershipsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// PageSize sets the optional parameter "pageSize": Maximum number of +// Memberships to return. +// +// View | Default | Maximum +// -----|---------|-------- +// BASIC | 200 | 1000 +// FULL | 50 | 500 +func (c *GroupsMembershipsListCall) PageSize(pageSize int64) *GroupsMembershipsListCall { + c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) + return c +} + +// PageToken sets the optional parameter "pageToken": The +// next_page_token value returned from a previous list request, if any. +func (c *GroupsMembershipsListCall) PageToken(pageToken string) *GroupsMembershipsListCall { + c.urlParams_.Set("pageToken", pageToken) + return c +} + +// View sets the optional parameter "view": Membership resource view to +// be returned. Defaults to View.BASIC. +// +// Possible values: +// "VIEW_UNSPECIFIED" +// "BASIC" +// "FULL" +func (c *GroupsMembershipsListCall) View(view string) *GroupsMembershipsListCall { + c.urlParams_.Set("view", view) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsMembershipsListCall) Fields(s ...googleapi.Field) *GroupsMembershipsListCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsMembershipsListCall) IfNoneMatch(entityTag string) *GroupsMembershipsListCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsMembershipsListCall) Context(ctx context.Context) *GroupsMembershipsListCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsMembershipsListCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsMembershipsListCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/memberships") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.memberships.list" call. +// Exactly one of *ListMembershipsResponse or error will be non-nil. Any +// non-2xx status code is an error. Response headers are in either +// *ListMembershipsResponse.ServerResponse.Header or (if a response was +// returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *GroupsMembershipsListCall) Do(opts ...googleapi.CallOption) (*ListMembershipsResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &ListMembershipsResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "List Memberships within a Group.", + // "flatPath": "v1/groups/{groupsId}/memberships", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.memberships.list", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "pageSize": { + // "description": "Maximum number of Memberships to return.\n\nView | Default | Maximum\n-----|---------|--------\nBASIC | 200 | 1000\nFULL | 50 | 500", + // "format": "int32", + // "location": "query", + // "type": "integer" + // }, + // "pageToken": { + // "description": "The next_page_token value returned from a previous list request, if any.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to list Memberships within.\n\nFormat: `groups/{group_id}`, where `group_id` is the unique ID assigned to\nthe Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // }, + // "view": { + // "description": "Membership resource view to be returned. Defaults to View.BASIC.", + // "enum": [ + // "VIEW_UNSPECIFIED", + // "BASIC", + // "FULL" + // ], + // "location": "query", + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/memberships", + // "response": { + // "$ref": "ListMembershipsResponse" + // } + // } + +} + +// Pages invokes f for each page of results. +// A non-nil error returned from f will halt the iteration. +// The provided context supersedes any context provided to the Context method. +func (c *GroupsMembershipsListCall) Pages(ctx context.Context, f func(*ListMembershipsResponse) error) error { + c.ctx_ = ctx + defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point + for { + x, err := c.Do() + if err != nil { + return err + } + if err := f(x); err != nil { + return err + } + if x.NextPageToken == "" { + return nil + } + c.PageToken(x.NextPageToken) + } +} + +// method id "cloudidentity.groups.memberships.lookup": + +type GroupsMembershipsLookupCall struct { + s *Service + parent string + urlParams_ gensupport.URLParams + ifNoneMatch_ string + ctx_ context.Context + header_ http.Header +} + +// Lookup: Looks up +// [resource +// name](https://cloud.google.com/apis/design/resource_names) of a +// Membership +// within a Group by member's EntityKey. +func (r *GroupsMembershipsService) Lookup(parent string) *GroupsMembershipsLookupCall { + c := &GroupsMembershipsLookupCall{s: r.s, urlParams_: make(gensupport.URLParams)} + c.parent = parent + return c +} + +// MemberKeyId sets the optional parameter "memberKey.id": The ID of the +// entity within the given namespace. The ID must be unique +// within its namespace. +func (c *GroupsMembershipsLookupCall) MemberKeyId(memberKeyId string) *GroupsMembershipsLookupCall { + c.urlParams_.Set("memberKey.id", memberKeyId) + return c +} + +// MemberKeyNamespace sets the optional parameter "memberKey.namespace": +// Namespaces provide isolation for IDs, so an ID only needs to be +// unique +// within its namespace. +// +// Namespaces are currently only created as part of IdentitySource +// creation +// from Admin Console. A namespace +// "identitysources/{identity_source_id}" is +// created corresponding to every Identity Source `identity_source_id`. +func (c *GroupsMembershipsLookupCall) MemberKeyNamespace(memberKeyNamespace string) *GroupsMembershipsLookupCall { + c.urlParams_.Set("memberKey.namespace", memberKeyNamespace) + return c +} + +// Fields allows partial responses to be retrieved. See +// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse +// for more information. +func (c *GroupsMembershipsLookupCall) Fields(s ...googleapi.Field) *GroupsMembershipsLookupCall { + c.urlParams_.Set("fields", googleapi.CombineFields(s)) + return c +} + +// IfNoneMatch sets the optional parameter which makes the operation +// fail if the object's ETag matches the given value. This is useful for +// getting updates only after the object has changed since the last +// request. Use googleapi.IsNotModified to check whether the response +// error from Do is the result of In-None-Match. +func (c *GroupsMembershipsLookupCall) IfNoneMatch(entityTag string) *GroupsMembershipsLookupCall { + c.ifNoneMatch_ = entityTag + return c +} + +// Context sets the context to be used in this call's Do method. Any +// pending HTTP request will be aborted if the provided context is +// canceled. +func (c *GroupsMembershipsLookupCall) Context(ctx context.Context) *GroupsMembershipsLookupCall { + c.ctx_ = ctx + return c +} + +// Header returns an http.Header that can be modified by the caller to +// add HTTP headers to the request. +func (c *GroupsMembershipsLookupCall) Header() http.Header { + if c.header_ == nil { + c.header_ = make(http.Header) + } + return c.header_ +} + +func (c *GroupsMembershipsLookupCall) doRequest(alt string) (*http.Response, error) { + reqHeaders := make(http.Header) + for k, v := range c.header_ { + reqHeaders[k] = v + } + reqHeaders.Set("User-Agent", c.s.userAgent()) + if c.ifNoneMatch_ != "" { + reqHeaders.Set("If-None-Match", c.ifNoneMatch_) + } + var body io.Reader = nil + c.urlParams_.Set("alt", alt) + c.urlParams_.Set("prettyPrint", "false") + urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+parent}/memberships:lookup") + urls += "?" + c.urlParams_.Encode() + req, err := http.NewRequest("GET", urls, body) + if err != nil { + return nil, err + } + req.Header = reqHeaders + googleapi.Expand(req.URL, map[string]string{ + "parent": c.parent, + }) + return gensupport.SendRequest(c.ctx_, c.s.client, req) +} + +// Do executes the "cloudidentity.groups.memberships.lookup" call. +// Exactly one of *LookupMembershipNameResponse or error will be +// non-nil. Any non-2xx status code is an error. Response headers are in +// either *LookupMembershipNameResponse.ServerResponse.Header or (if a +// response was returned at all) in error.(*googleapi.Error).Header. Use +// googleapi.IsNotModified to check whether the returned error was +// because http.StatusNotModified was returned. +func (c *GroupsMembershipsLookupCall) Do(opts ...googleapi.CallOption) (*LookupMembershipNameResponse, error) { + gensupport.SetOptions(c.urlParams_, opts...) + res, err := c.doRequest("json") + if res != nil && res.StatusCode == http.StatusNotModified { + if res.Body != nil { + res.Body.Close() + } + return nil, &googleapi.Error{ + Code: res.StatusCode, + Header: res.Header, + } + } + if err != nil { + return nil, err + } + defer googleapi.CloseBody(res) + if err := googleapi.CheckResponse(res); err != nil { + return nil, err + } + ret := &LookupMembershipNameResponse{ + ServerResponse: googleapi.ServerResponse{ + Header: res.Header, + HTTPStatusCode: res.StatusCode, + }, + } + target := &ret + if err := gensupport.DecodeResponse(target, res); err != nil { + return nil, err + } + return ret, nil + // { + // "description": "Looks up [resource\nname](https://cloud.google.com/apis/design/resource_names) of a Membership\nwithin a Group by member's EntityKey.", + // "flatPath": "v1/groups/{groupsId}/memberships:lookup", + // "httpMethod": "GET", + // "id": "cloudidentity.groups.memberships.lookup", + // "parameterOrder": [ + // "parent" + // ], + // "parameters": { + // "memberKey.id": { + // "description": "The ID of the entity within the given namespace. The ID must be unique\nwithin its namespace.", + // "location": "query", + // "type": "string" + // }, + // "memberKey.namespace": { + // "description": "Namespaces provide isolation for IDs, so an ID only needs to be unique\nwithin its namespace.\n\nNamespaces are currently only created as part of IdentitySource creation\nfrom Admin Console. A namespace `\"identitysources/{identity_source_id}\"` is\ncreated corresponding to every Identity Source `identity_source_id`.", + // "location": "query", + // "type": "string" + // }, + // "parent": { + // "description": "[Resource name](https://cloud.google.com/apis/design/resource_names) of the\nGroup to lookup Membership within.\n\nFormat: `groups/{group_id}`, where `group_id` is the unique ID assigned to\nthe Group.", + // "location": "path", + // "pattern": "^groups/[^/]+$", + // "required": true, + // "type": "string" + // } + // }, + // "path": "v1/{+parent}/memberships:lookup", + // "response": { + // "$ref": "LookupMembershipNameResponse" + // } + // } + +} diff --git a/datastore/v1/datastore-api.json b/datastore/v1/datastore-api.json index be61571ce1f..fe2f939061d 100644 --- a/datastore/v1/datastore-api.json +++ b/datastore/v1/datastore-api.json @@ -564,7 +564,7 @@ } } }, - "revision": "20180919", + "revision": "20181207", "rootUrl": "https://datastore.googleapis.com/", "schemas": { "AllocateIdsRequest": { @@ -967,7 +967,7 @@ "type": "object" }, "GoogleDatastoreAdminV1Index": { - "description": "A minimal index definition.\nNext tag: 8", + "description": "A minimal index definition.", "id": "GoogleDatastoreAdminV1Index", "properties": { "ancestor": { @@ -1044,7 +1044,7 @@ "type": "object" }, "GoogleDatastoreAdminV1IndexedProperty": { - "description": "Next tag: 3", + "description": "A property of an index.", "id": "GoogleDatastoreAdminV1IndexedProperty", "properties": { "direction": { diff --git a/datastore/v1/datastore-gen.go b/datastore/v1/datastore-gen.go index c6f8ad744bb..e8662b7981f 100644 --- a/datastore/v1/datastore-gen.go +++ b/datastore/v1/datastore-gen.go @@ -948,7 +948,6 @@ func (s *GoogleDatastoreAdminV1ImportEntitiesRequest) MarshalJSON() ([]byte, err } // GoogleDatastoreAdminV1Index: A minimal index definition. -// Next tag: 8 type GoogleDatastoreAdminV1Index struct { // Ancestor: The index's ancestor mode. Must not be // ANCESTOR_MODE_UNSPECIFIED. @@ -1066,7 +1065,7 @@ func (s *GoogleDatastoreAdminV1IndexOperationMetadata) MarshalJSON() ([]byte, er return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleDatastoreAdminV1IndexedProperty: Next tag: 3 +// GoogleDatastoreAdminV1IndexedProperty: A property of an index. type GoogleDatastoreAdminV1IndexedProperty struct { // Direction: The indexed property's direction. Must not be // DIRECTION_UNSPECIFIED. diff --git a/dialogflow/v2/dialogflow-api.json b/dialogflow/v2/dialogflow-api.json index ba8a6b567ac..f1310bebe93 100644 --- a/dialogflow/v2/dialogflow-api.json +++ b/dialogflow/v2/dialogflow-api.json @@ -1303,7 +1303,7 @@ } } }, - "revision": "20181207", + "revision": "20181215", "rootUrl": "https://dialogflow.googleapis.com/", "schemas": { "GoogleCloudDialogflowV2Agent": { @@ -2631,7 +2631,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The free-form diagnostic info. For example, this field\ncould contain webhook call latency.", + "description": "The free-form diagnostic info. For example, this field could contain\nwebhook call latency. The string keys of the Struct's fields map can change\nwithout notice.", "type": "object" }, "fulfillmentMessages": { @@ -2772,7 +2772,7 @@ "type": "string" }, "text": { - "description": "Required. The UTF-8 encoded natural language text to be processed.\nText length must not exceed 256 bytes.", + "description": "Required. The UTF-8 encoded natural language text to be processed.\nText length must not exceed 256 characters.", "type": "string" } }, @@ -2900,37 +2900,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV2beta1ConversationEvent": { - "description": "Represents a notification sent to Cloud Pub/Sub subscribers for conversation\nlifecycle events.", - "id": "GoogleCloudDialogflowV2beta1ConversationEvent", - "properties": { - "conversation": { - "description": "Required. The unique identifier of the conversation this notification\nrefers to. Format: `projects/\u003cProject ID\u003e/conversations/\u003cConversation ID\u003e`.", - "type": "string" - }, - "errorStatus": { - "$ref": "GoogleRpcStatus", - "description": "Optional. More detailed information about an error. Only set for type\nUNRECOVERABLE_ERROR_IN_PHONE_CALL." - }, - "type": { - "description": "Required. The type of the event that this notification refers to.", - "enum": [ - "TYPE_UNSPECIFIED", - "CONVERSATION_STARTED", - "CONVERSATION_FINISHED", - "UNRECOVERABLE_ERROR" - ], - "enumDescriptions": [ - "Type not set.", - "A new conversation has been opened. This is fired when a telephone call\nis answered, or a conversation is created via the API.", - "An existing conversation has closed. This is fired when a telephone call\nis terminated, or a conversation is closed via the API.", - "Unrecoverable error during a telephone call.\n\nIn general non-recoverable errors only occur if something was\nmisconfigured in the ConversationProfile corresponding to the call. After\na non-recoverable error, Dialogflow may stop responding.\n\nWe don't fire this event:\n* in an API call because we can directly return the error, or,\n* when we can recover from an error." - ], - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudDialogflowV2beta1EntityType": { "description": "Represents an entity type.\nEntity types serve as a tool for extracting parameter values from natural\nlanguage queries.", "id": "GoogleCloudDialogflowV2beta1EntityType", @@ -3036,29 +3005,6 @@ }, "type": "object" }, - "GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent": { - "description": "Represents a notification sent to Cloud Pub/Sub subscribers for\nagent assistant events in a specific conversation.", - "id": "GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent", - "properties": { - "conversation": { - "description": "Required. The conversation this notification refers to.\nFormat: `projects/\u003cProject ID\u003e/conversations/\u003cConversation ID\u003e`.", - "type": "string" - }, - "type": { - "description": "Required. The type of the event that this notification refers to.", - "enum": [ - "TYPE_UNSPECIFIED", - "NEW_SUGGESTION" - ], - "enumDescriptions": [ - "Type not set.", - "A new suggestion has been sent.\nThis is fired when a suggestion comes from an agent assistant." - ], - "type": "string" - } - }, - "type": "object" - }, "GoogleCloudDialogflowV2beta1Intent": { "description": "Represents an intent.\nIntents convert a number of user expressions or patterns into an action. An\naction is an extraction of a user command or sentence semantics.", "id": "GoogleCloudDialogflowV2beta1Intent", @@ -3884,7 +3830,7 @@ "description": "Properties of the object.", "type": "any" }, - "description": "The free-form diagnostic info. For example, this field\ncould contain webhook call latency.", + "description": "The free-form diagnostic info. For example, this field could contain\nwebhook call latency. The string keys of the Struct's fields map can change\nwithout notice.", "type": "object" }, "fulfillmentMessages": { diff --git a/dialogflow/v2/dialogflow-gen.go b/dialogflow/v2/dialogflow-gen.go index 3bb3c9177e7..bb81c1baccf 100644 --- a/dialogflow/v2/dialogflow-gen.go +++ b/dialogflow/v2/dialogflow-gen.go @@ -2824,8 +2824,10 @@ type GoogleCloudDialogflowV2QueryResult struct { AllRequiredParamsPresent bool `json:"allRequiredParamsPresent,omitempty"` // DiagnosticInfo: The free-form diagnostic info. For example, this - // field - // could contain webhook call latency. + // field could contain + // webhook call latency. The string keys of the Struct's fields map can + // change + // without notice. DiagnosticInfo googleapi.RawMessage `json:"diagnosticInfo,omitempty"` // FulfillmentMessages: The collection of rich messages to present to @@ -3132,7 +3134,7 @@ type GoogleCloudDialogflowV2TextInput struct { // Text: Required. The UTF-8 encoded natural language text to be // processed. - // Text length must not exceed 256 bytes. + // Text length must not exceed 256 characters. Text string `json:"text,omitempty"` // ForceSendFields is a list of field names (e.g. "LanguageCode") to @@ -3414,70 +3416,6 @@ func (s *GoogleCloudDialogflowV2beta1Context) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV2beta1ConversationEvent: Represents a -// notification sent to Cloud Pub/Sub subscribers for -// conversation -// lifecycle events. -type GoogleCloudDialogflowV2beta1ConversationEvent struct { - // Conversation: Required. The unique identifier of the conversation - // this notification - // refers to. Format: `projects//conversations/`. - Conversation string `json:"conversation,omitempty"` - - // ErrorStatus: Optional. More detailed information about an error. Only - // set for type - // UNRECOVERABLE_ERROR_IN_PHONE_CALL. - ErrorStatus *GoogleRpcStatus `json:"errorStatus,omitempty"` - - // Type: Required. The type of the event that this notification refers - // to. - // - // Possible values: - // "TYPE_UNSPECIFIED" - Type not set. - // "CONVERSATION_STARTED" - A new conversation has been opened. This - // is fired when a telephone call - // is answered, or a conversation is created via the API. - // "CONVERSATION_FINISHED" - An existing conversation has closed. This - // is fired when a telephone call - // is terminated, or a conversation is closed via the API. - // "UNRECOVERABLE_ERROR" - Unrecoverable error during a telephone - // call. - // - // In general non-recoverable errors only occur if something - // was - // misconfigured in the ConversationProfile corresponding to the call. - // After - // a non-recoverable error, Dialogflow may stop responding. - // - // We don't fire this event: - // * in an API call because we can directly return the error, or, - // * when we can recover from an error. - Type string `json:"type,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Conversation") to - // unconditionally include in API requests. By default, fields with - // empty values are omitted from API requests. However, any non-pointer, - // non-interface field appearing in ForceSendFields will be sent to the - // server regardless of whether the field is empty or not. This may be - // used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Conversation") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudDialogflowV2beta1ConversationEvent) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV2beta1ConversationEvent - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV2beta1EntityType: Represents an entity // type. // Entity types serve as a tool for extracting parameter values from @@ -3689,47 +3627,6 @@ func (s *GoogleCloudDialogflowV2beta1ExportAgentResponse) MarshalJSON() ([]byte, return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent: Represents a -// notification sent to Cloud Pub/Sub subscribers for -// agent assistant events in a specific conversation. -type GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent struct { - // Conversation: Required. The conversation this notification refers - // to. - // Format: `projects//conversations/`. - Conversation string `json:"conversation,omitempty"` - - // Type: Required. The type of the event that this notification refers - // to. - // - // Possible values: - // "TYPE_UNSPECIFIED" - Type not set. - // "NEW_SUGGESTION" - A new suggestion has been sent. - // This is fired when a suggestion comes from an agent assistant. - Type string `json:"type,omitempty"` - - // ForceSendFields is a list of field names (e.g. "Conversation") to - // unconditionally include in API requests. By default, fields with - // empty values are omitted from API requests. However, any non-pointer, - // non-interface field appearing in ForceSendFields will be sent to the - // server regardless of whether the field is empty or not. This may be - // used to include empty fields in Patch requests. - ForceSendFields []string `json:"-"` - - // NullFields is a list of field names (e.g. "Conversation") to include - // in API requests with the JSON null value. By default, fields with - // empty values are omitted from API requests. However, any field with - // an empty value appearing in NullFields will be sent to the server as - // null. It is an error if a field in this list has a non-empty value. - // This may be used to include null fields in Patch requests. - NullFields []string `json:"-"` -} - -func (s *GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent) MarshalJSON() ([]byte, error) { - type NoMethod GoogleCloudDialogflowV2beta1HumanAgentAssistantEvent - raw := NoMethod(*s) - return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) -} - // GoogleCloudDialogflowV2beta1Intent: Represents an intent. // Intents convert a number of user expressions or patterns into an // action. An @@ -5325,8 +5222,10 @@ type GoogleCloudDialogflowV2beta1QueryResult struct { AllRequiredParamsPresent bool `json:"allRequiredParamsPresent,omitempty"` // DiagnosticInfo: The free-form diagnostic info. For example, this - // field - // could contain webhook call latency. + // field could contain + // webhook call latency. The string keys of the Struct's fields map can + // change + // without notice. DiagnosticInfo googleapi.RawMessage `json:"diagnosticInfo,omitempty"` // FulfillmentMessages: The collection of rich messages to present to diff --git a/drive/v3/drive-api.json b/drive/v3/drive-api.json index fe4ddf81966..d75ae30f558 100644 --- a/drive/v3/drive-api.json +++ b/drive/v3/drive-api.json @@ -35,7 +35,7 @@ "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.", "discoveryVersion": "v1", "documentationLink": "https://developers.google.com/drive/", - "etag": "\"J3WqvAcMk4eQjJXvfSI4Yr8VouA/ESklhHtjidCDMugyP9gJKRCO-YM\"", + "etag": "\"J3WqvAcMk4eQjJXvfSI4Yr8VouA/DmsVwHXLUfZJqrDE1d-9tgSUvKk\"", "icons": { "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png", "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png" @@ -1770,7 +1770,7 @@ } } }, - "revision": "20181025", + "revision": "20181213", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -2260,6 +2260,14 @@ "description": "Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.", "type": "boolean" }, + "exportLinks": { + "additionalProperties": { + "description": "A mapping from export format to URL", + "type": "string" + }, + "description": "Links for exporting Google Docs to specific formats.", + "type": "object" + }, "fileExtension": { "description": "The final component of fullFileExtension. This is only available for files with binary content in Drive.", "type": "string" @@ -2844,6 +2852,14 @@ "description": "The metadata for a revision to a file.", "id": "Revision", "properties": { + "exportLinks": { + "additionalProperties": { + "description": "A mapping from export format to URL", + "type": "string" + }, + "description": "Links for exporting Google Docs to specific formats.", + "type": "object" + }, "id": { "description": "The ID of the revision.", "type": "string" diff --git a/drive/v3/drive-gen.go b/drive/v3/drive-gen.go index a3d085987c8..2bd84ea4c1b 100644 --- a/drive/v3/drive-gen.go +++ b/drive/v3/drive-gen.go @@ -702,6 +702,9 @@ type File struct { // opposed to recursively trashed from a parent folder. ExplicitlyTrashed bool `json:"explicitlyTrashed,omitempty"` + // ExportLinks: Links for exporting Google Docs to specific formats. + ExportLinks map[string]string `json:"exportLinks,omitempty"` + // FileExtension: The final component of fullFileExtension. This is only // available for files with binary content in Drive. FileExtension string `json:"fileExtension,omitempty"` @@ -1727,6 +1730,9 @@ func (s *ReplyList) MarshalJSON() ([]byte, error) { // Revision: The metadata for a revision to a file. type Revision struct { + // ExportLinks: Links for exporting Google Docs to specific formats. + ExportLinks map[string]string `json:"exportLinks,omitempty"` + // Id: The ID of the revision. Id string `json:"id,omitempty"` @@ -1779,7 +1785,7 @@ type Revision struct { // server. googleapi.ServerResponse `json:"-"` - // ForceSendFields is a list of field names (e.g. "Id") to + // ForceSendFields is a list of field names (e.g. "ExportLinks") to // unconditionally include in API requests. By default, fields with // empty values are omitted from API requests. However, any non-pointer, // non-interface field appearing in ForceSendFields will be sent to the @@ -1787,10 +1793,10 @@ type Revision struct { // used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` - // NullFields is a list of field names (e.g. "Id") to include in API - // requests with the JSON null value. By default, fields with empty - // values are omitted from API requests. However, any field with an - // empty value appearing in NullFields will be sent to the server as + // NullFields is a list of field names (e.g. "ExportLinks") to include + // in API requests with the JSON null value. By default, fields with + // empty values are omitted from API requests. However, any field with + // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` diff --git a/logging/v2/logging-api.json b/logging/v2/logging-api.json index 3fe403350ff..20b51d4de95 100644 --- a/logging/v2/logging-api.json +++ b/logging/v2/logging-api.json @@ -564,7 +564,7 @@ "entries": { "methods": { "list": { - "description": "Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log entries, see Exporting Logs.", + "description": "Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Exporting Logs.", "flatPath": "v2/entries:list", "httpMethod": "POST", "id": "logging.entries.list", @@ -2535,7 +2535,7 @@ } } }, - "revision": "20181020", + "revision": "20181215", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BucketOptions": { diff --git a/logging/v2/logging-gen.go b/logging/v2/logging-gen.go index 9545e889792..9eab8ea52e1 100644 --- a/logging/v2/logging-gen.go +++ b/logging/v2/logging-gen.go @@ -4410,8 +4410,9 @@ type EntriesListCall struct { header_ http.Header } -// List: Lists log entries. Use this method to retrieve log entries from -// Logging. For ways to export log entries, see Exporting Logs. +// List: Lists log entries. Use this method to retrieve log entries that +// originated from a project/folder/organization/billing account. For +// ways to export log entries, see Exporting Logs. func (r *EntriesService) List(listlogentriesrequest *ListLogEntriesRequest) *EntriesListCall { c := &EntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.listlogentriesrequest = listlogentriesrequest @@ -4505,7 +4506,7 @@ func (c *EntriesListCall) Do(opts ...googleapi.CallOption) (*ListLogEntriesRespo } return ret, nil // { - // "description": "Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log entries, see Exporting Logs.", + // "description": "Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Exporting Logs.", // "flatPath": "v2/entries:list", // "httpMethod": "POST", // "id": "logging.entries.list", diff --git a/logging/v2beta1/logging-api.json b/logging/v2beta1/logging-api.json index 31c5d26da77..a882ba50769 100644 --- a/logging/v2beta1/logging-api.json +++ b/logging/v2beta1/logging-api.json @@ -119,7 +119,7 @@ "entries": { "methods": { "list": { - "description": "Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log entries, see Exporting Logs.", + "description": "Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Exporting Logs.", "flatPath": "v2beta1/entries:list", "httpMethod": "POST", "id": "logging.entries.list", @@ -529,7 +529,7 @@ } } }, - "revision": "20181020", + "revision": "20181215", "rootUrl": "https://logging.googleapis.com/", "schemas": { "BucketOptions": { diff --git a/logging/v2beta1/logging-gen.go b/logging/v2beta1/logging-gen.go index 1f633e59df3..cc1a9e61183 100644 --- a/logging/v2beta1/logging-gen.go +++ b/logging/v2beta1/logging-gen.go @@ -1960,8 +1960,9 @@ type EntriesListCall struct { header_ http.Header } -// List: Lists log entries. Use this method to retrieve log entries from -// Logging. For ways to export log entries, see Exporting Logs. +// List: Lists log entries. Use this method to retrieve log entries that +// originated from a project/folder/organization/billing account. For +// ways to export log entries, see Exporting Logs. func (r *EntriesService) List(listlogentriesrequest *ListLogEntriesRequest) *EntriesListCall { c := &EntriesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.listlogentriesrequest = listlogentriesrequest @@ -2055,7 +2056,7 @@ func (c *EntriesListCall) Do(opts ...googleapi.CallOption) (*ListLogEntriesRespo } return ret, nil // { - // "description": "Lists log entries. Use this method to retrieve log entries from Logging. For ways to export log entries, see Exporting Logs.", + // "description": "Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Exporting Logs.", // "flatPath": "v2beta1/entries:list", // "httpMethod": "POST", // "id": "logging.entries.list", diff --git a/pubsub/v1/pubsub-api.json b/pubsub/v1/pubsub-api.json index b341ffba514..b9fb6a8f9e6 100644 --- a/pubsub/v1/pubsub-api.json +++ b/pubsub/v1/pubsub-api.json @@ -1074,7 +1074,7 @@ } } }, - "revision": "20181213", + "revision": "20181203", "rootUrl": "https://pubsub.googleapis.com/", "schemas": { "AcknowledgeRequest": { @@ -1267,7 +1267,7 @@ "id": "ModifyAckDeadlineRequest", "properties": { "ackDeadlineSeconds": { - "description": "The new ack deadline with respect to the time this request was sent to\nthe Pub/Sub system. For example, if the value is 10, the new\nack deadline will expire 10 seconds after the `ModifyAckDeadline` call\nwas made. Specifying zero might immediately make the message available for\ndelivery to another subscriber client. This typically results in an\nincrease in the rate of message redeliveries (that is, duplicates).\nThe minimum deadline you can specify is 0 seconds.\nThe maximum deadline you can specify is 600 seconds (10 minutes).", + "description": "The new ack deadline with respect to the time this request was sent to\nthe Pub/Sub system. For example, if the value is 10, the new\nack deadline will expire 10 seconds after the `ModifyAckDeadline` call\nwas made. Specifying zero may immediately make the message available for\nanother pull request.\nThe minimum deadline you can specify is 0 seconds.\nThe maximum deadline you can specify is 600 seconds (10 minutes).", "format": "int32", "type": "integer" }, diff --git a/pubsub/v1/pubsub-gen.go b/pubsub/v1/pubsub-gen.go index 17c8920789d..c961656c4e3 100644 --- a/pubsub/v1/pubsub-gen.go +++ b/pubsub/v1/pubsub-gen.go @@ -631,12 +631,9 @@ type ModifyAckDeadlineRequest struct { // the Pub/Sub system. For example, if the value is 10, the new // ack deadline will expire 10 seconds after the `ModifyAckDeadline` // call - // was made. Specifying zero might immediately make the message - // available for - // delivery to another subscriber client. This typically results in - // an - // increase in the rate of message redeliveries (that is, - // duplicates). + // was made. Specifying zero may immediately make the message available + // for + // another pull request. // The minimum deadline you can specify is 0 seconds. // The maximum deadline you can specify is 600 seconds (10 minutes). AckDeadlineSeconds int64 `json:"ackDeadlineSeconds,omitempty"` diff --git a/servicecontrol/v1/servicecontrol-api.json b/servicecontrol/v1/servicecontrol-api.json index 143feabb6fd..c5852a84b4e 100644 --- a/servicecontrol/v1/servicecontrol-api.json +++ b/servicecontrol/v1/servicecontrol-api.json @@ -196,7 +196,7 @@ } } }, - "revision": "20181210", + "revision": "20181214", "rootUrl": "https://servicecontrol.googleapis.com/", "schemas": { "AllocateInfo": { @@ -396,6 +396,10 @@ "description": "The email address of the authenticated user (or service account on behalf\nof third party principal) making the request. For privacy reasons, the\nprincipal email address is redacted for all read-only operations that fail\nwith a \"permission denied\" error.", "type": "string" }, + "serviceAccountKeyName": { + "description": "The name of the service account key used to create or exchange\ncredentials for authenticating the service account making the request.\nThis is a scheme-less URI full resource name. For example:\n\n\"//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}\"", + "type": "string" + }, "thirdPartyPrincipal": { "additionalProperties": { "description": "Properties of the object.", @@ -509,7 +513,7 @@ "The backend server for checking quota limits is unavailable.", "The Spanner for looking up LOAS project is unavailable.", "Cloud Resource Manager backend server is unavailable.", - "Backend server for evaluating security policy is unavailable.", + "NOTE: for customers in the scope of Beta/GA of\nhttps://cloud.google.com/vpc-service-controls, this error\nis no longer returned. If the security backend is unavailable, rpc\nUNAVAILABLE status will be returned instead. It should be ignored and\nshould not be used to reject client requests.", "Backend server for evaluating location policy is unavailable." ], "type": "string" diff --git a/servicecontrol/v1/servicecontrol-gen.go b/servicecontrol/v1/servicecontrol-gen.go index e937b33bd67..e41cb9e55e1 100644 --- a/servicecontrol/v1/servicecontrol-gen.go +++ b/servicecontrol/v1/servicecontrol-gen.go @@ -464,6 +464,17 @@ type AuthenticationInfo struct { // with a "permission denied" error. PrincipalEmail string `json:"principalEmail,omitempty"` + // ServiceAccountKeyName: The name of the service account key used to + // create or exchange + // credentials for authenticating the service account making the + // request. + // This is a scheme-less URI full resource name. For + // example: + // + // "//iam.googleapis.com/projects/{PROJECT_ID}/serviceAccounts/ + // {ACCOUNT}/keys/{key}" + ServiceAccountKeyName string `json:"serviceAccountKeyName,omitempty"` + // ThirdPartyPrincipal: The third party identification (if any) of the // authenticated user making // the request. @@ -622,8 +633,14 @@ type CheckError struct { // project is unavailable. // "CLOUD_RESOURCE_MANAGER_BACKEND_UNAVAILABLE" - Cloud Resource // Manager backend server is unavailable. - // "SECURITY_POLICY_BACKEND_UNAVAILABLE" - Backend server for - // evaluating security policy is unavailable. + // "SECURITY_POLICY_BACKEND_UNAVAILABLE" - NOTE: for customers in the + // scope of Beta/GA of + // https://cloud.google.com/vpc-service-controls, this error + // is no longer returned. If the security backend is unavailable, + // rpc + // UNAVAILABLE status will be returned instead. It should be ignored + // and + // should not be used to reject client requests. // "LOCATION_POLICY_BACKEND_UNAVAILABLE" - Backend server for // evaluating location policy is unavailable. Code string `json:"code,omitempty"`