Returns the entities Resource.
Close httplib2 connections.
get(name, contextMetadata=None, executionConfig_headers=None, view=None, x__xgafv=None)
Gets metadata of given entity type
list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)
Lists metadata related to all entity types present in the external system.
Retrieves the next page of results.
close()
Close httplib2 connections.
get(name, contextMetadata=None, executionConfig_headers=None, view=None, x__xgafv=None)
Gets metadata of given entity type
Args:
name: string, Required. Resource name of the Entity Type. Format: projects/{project}/locations/{location}/connections/{connection}/entityTypes/{entityType} (required)
contextMetadata: string, Context metadata for request could be used to fetch customization of entity type schema.
executionConfig_headers: string, headers to be used for the request. For example: headers:'{"x-integration-connectors-managed-connection-id":"conn-id","x-integration-connectors-runtime-config":"runtime-cfg"}'
view: string, Specifies view for entity type schema.
Allowed values
ENTITY_TYPE_SCHEMA_VIEW_UNSPECIFIED - VIEW_UNSPECIFIED. The unset value. Defaults to BASIC View.
ENTITY_TYPE_SCHEMA_VIEW_BASIC - Return basic entity type schema.
ENTITY_TYPE_SCHEMA_VIEW_ENRICHED - Return enriched entity types schema.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # EntityType message contains metadata information about a single entity type present in the external system.
"defaultSortBy": "A String",
"fields": [ # List containing metadata information about each field of the entity type.
{ # Message contains EntityType's Field metadata.
"additionalDetails": { # The following map contains fields that are not explicitly mentioned above,this give connectors the flexibility to add new metadata fields.
"a_key": "", # Properties of the object.
},
"dataType": "A String", # The data type of the Field.
"defaultValue": "", # The following field specifies the default value of the Field provided by the external system if a value is not provided.
"description": "A String", # A brief description of the Field.
"jsonSchema": { # JsonSchema representation of schema metadata # JsonSchema of the field, applicable only if field is of type `STRUCT`
"$comment": "A String", # A comment on the schema.
"$defs": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"$id": "A String", # The URI defining the core schema meta-schema.
"$ref": "A String", # A reference to another schema.
"$schema": "A String", # The URI defining the schema.
"additionalDetails": { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
"a_key": "", # Properties of the object.
},
"additionalItems": # Object with schema name: JsonSchema # Schema for additional items.
"additionalProperties": # Object with schema name: JsonSchema # Schema for additional properties.
"allOf": [ # Schema that must be valid against all of the sub-schemas.
# Object with schema name: JsonSchema
],
"anyOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"const": "", # Const value that the data must match.
"contains": # Object with schema name: JsonSchema # Schema that applies to at least one item in an array.
"contentEncoding": "A String", # Encoding of the content.
"contentMediaType": "A String", # Media type of the content.
"default": "", # The default value of the field or object described by this schema.
"definitions": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"dependencies": { # Dependencies for the schema.
"a_key": "",
},
"description": "A String", # A description of this schema.
"else": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is invalid.
"enum": [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
"",
],
"examples": [ # Examples of the value.
"",
],
"exclusiveMaximum": "", # Whether the maximum number value is exclusive.
"exclusiveMinimum": "", # Whether the minimum number value is exclusive.
"format": "A String", # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
"if": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"items": # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
"jdbcType": "A String", # JDBC datatype of the field.
"maxItems": 42, # Maximum number of items in the array field.
"maxLength": 42, # Maximum length of the string field.
"maxProperties": 42, # Maximum number of properties.
"maximum": "", # Maximum value of the number field.
"minItems": 42, # Minimum number of items in the array field.
"minLength": 42, # Minimum length of the string field.
"minProperties": 42, # Minimum number of properties.
"minimum": "", # Minimum value of the number field.
"multipleOf": 3.14, # Number must be a multiple of this value.
"not": # Object with schema name: JsonSchema # Schema that must not be valid.
"oneOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"pattern": "A String", # Regex pattern of the string field. This is a string value that describes the regular expression that the string value should match.
"patternProperties": { # Pattern properties for the schema.
"a_key": # Object with schema name: JsonSchema
},
"properties": { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
"a_key": # Object with schema name: JsonSchema
},
"propertyNames": # Object with schema name: JsonSchema # Schema for property names.
"readOnly": True or False, # Whether the value is read-only.
"required": [ # Whether this property is required.
"A String",
],
"then": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"title": "A String", # A title of the schema.
"type": [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
"A String",
],
"uniqueItems": True or False, # Whether the items in the array field are unique.
"writeOnly": True or False, # Whether the value is write-only.
},
"key": True or False, # The following boolean field specifies if the current Field acts as a primary key or id if the parent is of type entity.
"name": "A String", # Name of the Field.
"nullable": True or False, # Specifies whether a null value is allowed.
"reference": { # Reference captures the association between two different entity types. Value links to the reference of another entity type.
"name": "A String", # Name of the reference field.
"type": "A String", # Name of reference entity type.
},
},
],
"jsonSchema": { # JsonSchema representation of schema metadata # JsonSchema representation of this entity's schema
"$comment": "A String", # A comment on the schema.
"$defs": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"$id": "A String", # The URI defining the core schema meta-schema.
"$ref": "A String", # A reference to another schema.
"$schema": "A String", # The URI defining the schema.
"additionalDetails": { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
"a_key": "", # Properties of the object.
},
"additionalItems": # Object with schema name: JsonSchema # Schema for additional items.
"additionalProperties": # Object with schema name: JsonSchema # Schema for additional properties.
"allOf": [ # Schema that must be valid against all of the sub-schemas.
# Object with schema name: JsonSchema
],
"anyOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"const": "", # Const value that the data must match.
"contains": # Object with schema name: JsonSchema # Schema that applies to at least one item in an array.
"contentEncoding": "A String", # Encoding of the content.
"contentMediaType": "A String", # Media type of the content.
"default": "", # The default value of the field or object described by this schema.
"definitions": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"dependencies": { # Dependencies for the schema.
"a_key": "",
},
"description": "A String", # A description of this schema.
"else": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is invalid.
"enum": [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
"",
],
"examples": [ # Examples of the value.
"",
],
"exclusiveMaximum": "", # Whether the maximum number value is exclusive.
"exclusiveMinimum": "", # Whether the minimum number value is exclusive.
"format": "A String", # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
"if": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"items": # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
"jdbcType": "A String", # JDBC datatype of the field.
"maxItems": 42, # Maximum number of items in the array field.
"maxLength": 42, # Maximum length of the string field.
"maxProperties": 42, # Maximum number of properties.
"maximum": "", # Maximum value of the number field.
"minItems": 42, # Minimum number of items in the array field.
"minLength": 42, # Minimum length of the string field.
"minProperties": 42, # Minimum number of properties.
"minimum": "", # Minimum value of the number field.
"multipleOf": 3.14, # Number must be a multiple of this value.
"not": # Object with schema name: JsonSchema # Schema that must not be valid.
"oneOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"pattern": "A String", # Regex pattern of the string field. This is a string value that describes the regular expression that the string value should match.
"patternProperties": { # Pattern properties for the schema.
"a_key": # Object with schema name: JsonSchema
},
"properties": { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
"a_key": # Object with schema name: JsonSchema
},
"propertyNames": # Object with schema name: JsonSchema # Schema for property names.
"readOnly": True or False, # Whether the value is read-only.
"required": [ # Whether this property is required.
"A String",
],
"then": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"title": "A String", # A title of the schema.
"type": [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
"A String",
],
"uniqueItems": True or False, # Whether the items in the array field are unique.
"writeOnly": True or False, # Whether the value is write-only.
},
"metadata": { # Metadata like service latency, etc.
"a_key": {
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
},
"name": "A String", # The name of the entity type.
"operations": [
"A String",
],
}
list(parent, executionConfig_headers=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)
Lists metadata related to all entity types present in the external system.
Args:
parent: string, Required. Resource name of the Entity Type. Format: projects/{project}/locations/{location}/connections/{connection} (required)
executionConfig_headers: string, headers to be used for the request. For example: headers:'{"x-integration-connectors-managed-connection-id":"conn-id","x-integration-connectors-runtime-config":"runtime-cfg"}'
pageSize: integer, Number of entity types to return. Defaults to 25.
pageToken: string, Page token, return from a previous ListEntityTypes call, that can be used retrieve the next page of content. If unspecified, the request returns the first page of entity types.
view: string, Specifies which fields of the Entity Type are returned in the response.
Allowed values
ENTITY_TYPE_VIEW_UNSPECIFIED - VIEW_UNSPECIFIED. The unset value. Defaults to FULL View.
ENTITY_TYPE_VIEW_BASIC - Return only entity type names.
ENTITY_TYPE_VIEW_FULL - Return entity types with schema
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for EntityService.ListEntityTypes
"metadata": { # Metadata like service latency, etc.
"a_key": {
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
},
"nextPageToken": "A String", # Next page token if more entity types available.
"types": [ # List of metadata related to all entity types.
{ # EntityType message contains metadata information about a single entity type present in the external system.
"defaultSortBy": "A String",
"fields": [ # List containing metadata information about each field of the entity type.
{ # Message contains EntityType's Field metadata.
"additionalDetails": { # The following map contains fields that are not explicitly mentioned above,this give connectors the flexibility to add new metadata fields.
"a_key": "", # Properties of the object.
},
"dataType": "A String", # The data type of the Field.
"defaultValue": "", # The following field specifies the default value of the Field provided by the external system if a value is not provided.
"description": "A String", # A brief description of the Field.
"jsonSchema": { # JsonSchema representation of schema metadata # JsonSchema of the field, applicable only if field is of type `STRUCT`
"$comment": "A String", # A comment on the schema.
"$defs": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"$id": "A String", # The URI defining the core schema meta-schema.
"$ref": "A String", # A reference to another schema.
"$schema": "A String", # The URI defining the schema.
"additionalDetails": { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
"a_key": "", # Properties of the object.
},
"additionalItems": # Object with schema name: JsonSchema # Schema for additional items.
"additionalProperties": # Object with schema name: JsonSchema # Schema for additional properties.
"allOf": [ # Schema that must be valid against all of the sub-schemas.
# Object with schema name: JsonSchema
],
"anyOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"const": "", # Const value that the data must match.
"contains": # Object with schema name: JsonSchema # Schema that applies to at least one item in an array.
"contentEncoding": "A String", # Encoding of the content.
"contentMediaType": "A String", # Media type of the content.
"default": "", # The default value of the field or object described by this schema.
"definitions": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"dependencies": { # Dependencies for the schema.
"a_key": "",
},
"description": "A String", # A description of this schema.
"else": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is invalid.
"enum": [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
"",
],
"examples": [ # Examples of the value.
"",
],
"exclusiveMaximum": "", # Whether the maximum number value is exclusive.
"exclusiveMinimum": "", # Whether the minimum number value is exclusive.
"format": "A String", # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
"if": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"items": # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
"jdbcType": "A String", # JDBC datatype of the field.
"maxItems": 42, # Maximum number of items in the array field.
"maxLength": 42, # Maximum length of the string field.
"maxProperties": 42, # Maximum number of properties.
"maximum": "", # Maximum value of the number field.
"minItems": 42, # Minimum number of items in the array field.
"minLength": 42, # Minimum length of the string field.
"minProperties": 42, # Minimum number of properties.
"minimum": "", # Minimum value of the number field.
"multipleOf": 3.14, # Number must be a multiple of this value.
"not": # Object with schema name: JsonSchema # Schema that must not be valid.
"oneOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"pattern": "A String", # Regex pattern of the string field. This is a string value that describes the regular expression that the string value should match.
"patternProperties": { # Pattern properties for the schema.
"a_key": # Object with schema name: JsonSchema
},
"properties": { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
"a_key": # Object with schema name: JsonSchema
},
"propertyNames": # Object with schema name: JsonSchema # Schema for property names.
"readOnly": True or False, # Whether the value is read-only.
"required": [ # Whether this property is required.
"A String",
],
"then": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"title": "A String", # A title of the schema.
"type": [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
"A String",
],
"uniqueItems": True or False, # Whether the items in the array field are unique.
"writeOnly": True or False, # Whether the value is write-only.
},
"key": True or False, # The following boolean field specifies if the current Field acts as a primary key or id if the parent is of type entity.
"name": "A String", # Name of the Field.
"nullable": True or False, # Specifies whether a null value is allowed.
"reference": { # Reference captures the association between two different entity types. Value links to the reference of another entity type.
"name": "A String", # Name of the reference field.
"type": "A String", # Name of reference entity type.
},
},
],
"jsonSchema": { # JsonSchema representation of schema metadata # JsonSchema representation of this entity's schema
"$comment": "A String", # A comment on the schema.
"$defs": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"$id": "A String", # The URI defining the core schema meta-schema.
"$ref": "A String", # A reference to another schema.
"$schema": "A String", # The URI defining the schema.
"additionalDetails": { # Additional details apart from standard json schema fields, this gives flexibility to store metadata about the schema
"a_key": "", # Properties of the object.
},
"additionalItems": # Object with schema name: JsonSchema # Schema for additional items.
"additionalProperties": # Object with schema name: JsonSchema # Schema for additional properties.
"allOf": [ # Schema that must be valid against all of the sub-schemas.
# Object with schema name: JsonSchema
],
"anyOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"const": "", # Const value that the data must match.
"contains": # Object with schema name: JsonSchema # Schema that applies to at least one item in an array.
"contentEncoding": "A String", # Encoding of the content.
"contentMediaType": "A String", # Media type of the content.
"default": "", # The default value of the field or object described by this schema.
"definitions": { # Definitions for the schema.
"a_key": # Object with schema name: JsonSchema
},
"dependencies": { # Dependencies for the schema.
"a_key": "",
},
"description": "A String", # A description of this schema.
"else": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is invalid.
"enum": [ # Possible values for an enumeration. This works in conjunction with `type` to represent types with a fixed set of legal values
"",
],
"examples": [ # Examples of the value.
"",
],
"exclusiveMaximum": "", # Whether the maximum number value is exclusive.
"exclusiveMinimum": "", # Whether the minimum number value is exclusive.
"format": "A String", # Format of the value as per https://json-schema.org/understanding-json-schema/reference/string.html#format
"if": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"items": # Object with schema name: JsonSchema # Schema that applies to array values, applicable only if this is of type `array`.
"jdbcType": "A String", # JDBC datatype of the field.
"maxItems": 42, # Maximum number of items in the array field.
"maxLength": 42, # Maximum length of the string field.
"maxProperties": 42, # Maximum number of properties.
"maximum": "", # Maximum value of the number field.
"minItems": 42, # Minimum number of items in the array field.
"minLength": 42, # Minimum length of the string field.
"minProperties": 42, # Minimum number of properties.
"minimum": "", # Minimum value of the number field.
"multipleOf": 3.14, # Number must be a multiple of this value.
"not": # Object with schema name: JsonSchema # Schema that must not be valid.
"oneOf": [ # Schema that must be valid against at least one of the sub-schemas.
# Object with schema name: JsonSchema
],
"pattern": "A String", # Regex pattern of the string field. This is a string value that describes the regular expression that the string value should match.
"patternProperties": { # Pattern properties for the schema.
"a_key": # Object with schema name: JsonSchema
},
"properties": { # The child schemas, applicable only if this is of type `object`. The key is the name of the property and the value is the json schema that describes that property
"a_key": # Object with schema name: JsonSchema
},
"propertyNames": # Object with schema name: JsonSchema # Schema for property names.
"readOnly": True or False, # Whether the value is read-only.
"required": [ # Whether this property is required.
"A String",
],
"then": # Object with schema name: JsonSchema # Schema that must be valid if the "if" schema is valid.
"title": "A String", # A title of the schema.
"type": [ # JSON Schema Validation: A Vocabulary for Structural Validation of JSON
"A String",
],
"uniqueItems": True or False, # Whether the items in the array field are unique.
"writeOnly": True or False, # Whether the value is write-only.
},
"metadata": { # Metadata like service latency, etc.
"a_key": {
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
},
"name": "A String", # The name of the entity type.
"operations": [
"A String",
],
},
],
"unsupportedTypeNames": [ # List of entity type names which contain unsupported Datatypes. Check datatype.proto for more information.
"A String",
],
}
list_next()
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.