Describes an analysis set
Field | Type | Label | Description |
analysis_set_id | string | UUID for the current analysis set |
|
description | string | Name or description for the analysis set |
|
created_date | google.protobuf.Timestamp | Creation timestamp |
|
filter_json | string | Interaction filter definition |
|
num_sessions | uint32 | Number of sessions included in the analysis set |
|
num_interactions | uint32 | Number of interactions included in the analysis set |
|
job_status_json | string | Current status for the analysis set creation as json |
|
filter_summary | string | Short description of the filter used |
|
analysis_set_status | AnalysisSet.AnalysisSetStatus | Current status for the analysis set |
|
settings_json | string | Current settings used |
|
analysis_json | string | Analysis set description as a json string |
|
properties | AnalysisSetProperties | Analysis set properties |
Creates an analysis set based on the requested filter
Field | Type | Label | Description |
filter_options | AnalysisSetFilterOptions | Creation filter |
|
analysis_set_name | string | The name (description) of the new analysis set created |
Returns the new created analysis set identifier
Field | Type | Label | Description |
analysis_set_id | string | UUID of the new analysis set created |
Deletes an existing analysis set
Field | Type | Label | Description |
analysis_set_id | string | UUID of the target analysis set |
Empty response for deletion operation
Defines a filter for analysis set creation
Field | Type | Label | Description |
start_timestamp | google.protobuf.Timestamp | Start timestamp for the interval |
|
end_timestamp | google.protobuf.Timestamp | End timestamp for the interval |
|
interaction_type | InteractionType | Interaction type filter |
|
sub_type | InteractionSubType | Interaction SubType |
|
final_result_status | FinalResultStatus | Interaction status filter |
|
language_string | string | Interaction language filter |
|
grammar_hash | string | Specific grammars filter |
|
properties | AnalysisSetProperties | Analysis set properties |
|
enhanced_transcription | bool | Flag for enhanced transcriptions |
Request for analysisSet retrieval
Field | Type | Label | Description |
analysis_set_id | string | UUID of the target analysis set |
Returns the requested analysis set
Field | Type | Label | Description |
analysis_set | AnalysisSet | Requested analysis set |
Defines a filter for analysis set list
Field | Type | Label | Description |
created_date_from | google.protobuf.Timestamp | Start timestamp for the interval |
|
created_date_to | google.protobuf.Timestamp | End timestamp for the interval |
|
type | InteractionType | Interaction type filter |
|
description | string | Description (name) filter |
Creates a request / filter for analysis set retrieval
Field | Type | Label | Description |
page_size | uint32 | Number of records per page (optional). Accepted values 1-100, default 10 |
|
starting_at | uint32 | Records offset for applied filter (optional), default 0 |
|
list_order | AnalysisSetListRequest.AnalysisSetListOrder | repeated | Analysis set list order (optional), default created_date |
filter | AnalysisSetListFilterOptions | Additional filtering options (optional, e.g. by type or language...) |
Returns a list of analysis sets
Field | Type | Label | Description |
analysis_set_list | AnalysisSet | repeated | The list of requested analysis sets |
total_number_of_matched | uint32 | The number of analysis sets in the response |
Requests the number of interactions and sessions generated by an
AnalysisSetCreate filter
Field | Type | Label | Description |
filter_options | AnalysisSetFilterOptions | Analysis set filter |
Returns the number of sessions and interactions generated by an
AnalysisSetCreate filter
Field | Type | Label | Description |
sessions_extract_needed | uint32 | Number of sessions |
|
interactions_extract_needed | uint32 | Number of interactions |
Stores the analysis set properties
Field | Type | Label | Description |
combine_business_and_residence | bool | Flag to combine Human Business and Human Residence for CPA results |
Describes the binary data entry structure
Field | Type | Label | Description |
storage_id | string | Binary storage identifier |
|
deployment_id | string | Deployment identifier |
|
tag | string | Associated tag for the binary data |
|
data | bytes | Binary data |
|
data_type | DataType | Type of the binary data |
ComponentLicenseUsage
Describes component for license usage
Field | Type | Label | Description |
usage_count | uint32 | number of operations for this component |
|
usage_ms | uint32 | milliseconds used for this component |
Describes Post-Processing profile creation request
Field | Type | Label | Description |
name | string | Name of this profile |
|
description | string | Optional human-readable description |
|
operations | RegexOperation | repeated | Array of regex operations |
Describes Post-Processing profile creation response
Field | Type | Label | Description |
profile_id | string | Contains the GUID (UUID) string of the newly created profile |
Describes Post-Processing profile Delete request
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile to delete |
Describes Post-Processing profile Delete response
Field | Type | Label | Description |
profile_id | string | UUID of deleted Post-Processing Profile |
Describes the diagnostic request message
Field | Type | Label | Description |
type | DiagnosticsType | Diagnostic type to be executed |
Describes the diagnostic response message
Field | Type | Label | Description |
errorMessage | string | Error message in case of errors or empty sting if the diagnostic check was successful |
|
versionString | string | The version number of the resource being checked, if appropriate |
|
latencyMs | int32 | Number of milliseconds needed to obtain a diagnostic response |
Describes the evaluate request
Field | Type | Label | Description |
machine_transcribed_text | string | asr engine result |
|
human_transcribed_text | string | human transcription |
Describes the Evaluate response
Field | Type | Label | Description |
match | float | match score |
|
error_text | string | differences between machine and huma transcriptions |
|
html_text | string | transcribed text with highlighted differences using html tags |
Describes an Analysis Set export request
Field | Type | Label | Description |
analysis_set_id | string | UUID of the analysis set selected for export |
Describes an Analysis Set export response
Field | Type | Label | Description |
status | google.rpc.Status | The export status. |
|
analysis_set_id | string | UUID of the analysis set selected for export |
|
analysis_set_description | string | Description of the exported analysis set |
|
archived_data | bytes | archived analysis set data |
Describes Post-Processing profile exporting request
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile to export |
Describes Post-Processing profile exporting response
Field | Type | Label | Description |
export_data | google.protobuf.Struct | serialized profile data |
Describes Post-Processing profile versions history request
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile |
Describes Post-Processing profile versions history response
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile (immutable) |
|
versions | PostProcessingProfile | repeated | Array of all versions of the Post-Processing Profile |
Describes Post-Processing profile Get request
Field | Type | Label | Description |
profile_id | string | Contains the GUID (UUID) string of Post-Processing profile |
Describes Post-Processing profile Get response
Field | Type | Label | Description |
profile | PostProcessingProfile | Contains requested Post-Processing profile message |
Describes Post-Processing profiles Get request
Currently empty, can be extended with profiles filtering parameters
Describes Post-Processing profiles Get response
Field | Type | Label | Description |
profiles | PostProcessingProfile | repeated |
|
Request for ThirdPartyLicenses
Currently no fields required
Response for ThirdPartyLicenses request
Field | Type | Label | Description |
third_party_licenses | string | Text for ThirdPartyLicense description |
Describes an Analysis Set import request
Field | Type | Label | Description |
analysis_set_description | string | Description for the imported analysis set |
|
archived_data | bytes | archived analysis set data |
Describes an Analysis Set import response
Field | Type | Label | Description |
status | google.rpc.Status | The import status. |
|
analysis_set_id | string | UUID of the imported analysis set |
Describes Post-Processing profile importing request
Field | Type | Label | Description |
import_data | google.protobuf.Struct | serialized JSON profile data |
Describes Post-Processing profile importing response
Field | Type | Label | Description |
profile_id | string | UUID of the imported Post-Processing Profile |
Defines the Interaction filter within an analysis set
Field | Type | Label | Description |
session_id | string | Lumenvox session identifier |
|
start_timestamp | google.protobuf.Timestamp | Start date time |
|
end_timestamp | google.protobuf.Timestamp | End date time |
|
grammar_hash | string | Include selected grammars |
|
ssml_hash | string | Include selected ssml |
|
search_text | string | Search text |
Creates a request for interaction details retrieval
Field | Type | Label | Description |
interaction_id | string | UUID of the interaction |
|
analysis_set_id | string | UUID for the analysis set |
Returns the InteractionDetails for requested interaction / analysis set
Field | Type | Label | Description |
interaction | InteractionDetails | Interaction details message |
Creates a request for analysis set retrieval based on predefined filters
Field | Type | Label | Description |
analysis_set_id | string | Identifier of analysis set (required) |
|
page_size | uint32 | Page size, accepted values 1-100, default 10 (optional) |
|
starting_at | uint32 | Records offset for applied filter, default 0 (optional) |
|
list_order | InteractionAnalysisListRequest.InteractionAnalysisListOrder | repeated | Set analysis set order, default created_date (optional) |
filter | InteractionAnalysisFilterOptions | Additional filtering options (e.g. by type or language...) (optional) |
Returns a filtered list of interactions within selected analysis set
Field | Type | Label | Description |
interaction_list | InteractionDetails | repeated | List of Interactions |
total_number_of_matched | uint32 | Total number of entries in the list |
|
total_number_of_transcribed | uint32 | Total number of transcribed entries in the list |
Update asr transcription message
Field | Type | Label | Description |
interaction_id | string | UUID for interaction |
|
analysis_set_id | string | UUID of analysis set |
|
transcript_text | string | New transcription value |
|
transcript_si | string | New transcription semantic interpretation |
|
notes | string | Notes |
Updates the transcription for an asr interaction
Field | Type | Label | Description |
interactionAnalysis | InteractionAnalysisUpdateTranscription | Update transcription message |
Updates asr transcription response
Field | Type | Label | Description |
status | google.rpc.Status | Operation status |
|
interaction | InteractionDetails | Product interaction within a session |
Describes one interaction
Field | Type | Label | Description |
id | string | New interaction UUID |
|
analysis_set_id | string | Analysis set uuid |
|
session_id | string | Original session identifier |
|
interaction_id | string | Original interaction identifier |
|
main_type | InteractionType | Base or Original Interaction type: ASR, TTS |
|
status | InteractionAnalysisStatus | Analysis status |
|
channel_id | uint32 | Audio channel identifier |
|
audio_format | AudioFormat | Audio format |
|
error | string | Error |
|
start_timestamp | google.protobuf.Timestamp | Processing start timestamp |
|
end_timestamp | google.protobuf.Timestamp | Processing end timestamp |
|
transcript_text | string | Transcribed text |
|
transcript_semantic | string | Transcribed semantic |
|
original_result | InteractionResultSet | Original interaction result |
|
tuned_result | InteractionResultSet | Tuned interaction result |
|
status_text | string | Analysis status text |
|
html_error | string | Error text in html format |
|
type | InteractionType | Converted Interaction type: CPA, TTS |
|
sub_type | InteractionSubType | Interaction SubType |
|
notes | string | Notes |
Describes an interaction result with current settings and grammars
Field | Type | Label | Description |
settings | InteractionSettings | Interaction settings |
|
text | string | Returned text |
|
semantic | string | Returned semantic |
|
score | uint32 | Confidence |
|
grammar_hash | string | repeated | Grammars used |
ssml_hash | string | repeated | Ssmls used |
interaction_result | Result | Interaction result |
|
decode_time | uint32 | Decode time |
|
confidence_threshold | float | Confidence Threshold |
|
interaction_request | string | Interaction Request |
|
final_result_status | FinalResultStatus | Final status of the interaction |
|
log_events | LogEvent | repeated | Interaction Events |
phrases | TranscriptionPhraseList | repeated | Optional phrase lists for transcription interaction |
final_result_status_text | string | Final result status text |
|
session_settings | SessionSettings | Session settings |
|
phrases_hash | string | repeated | Phrases used |
archive_metadata | bytes | Archive metadata |
LicenseStatusReportPullRequest sent to request license report status info
no fields
LicenseStatusReportPullResponse contains information provided by license
service with corresponding id which will be matched later when receiving
response from lumenvox cloud licensing server
Field | Type | Label | Description |
license_status_id | string | unique license status id |
|
license_status_report_json | string | license status report received from license service |
|
status | google.rpc.Status | response status |
LicenseStatusReportResponsePushRequest contains information from lumenvox
license cloud services which are then sent to license service for validation
Field | Type | Label | Description |
license_status_id | string | unique license status id |
|
license_status_report_response_json | string | license status response retrieved from lumenvox cloud license server |
LicenseStatusReportResponsePushResponse contains status determining if
request was successfully processed
Field | Type | Label | Description |
status | google.rpc.Status | response status |
Describes the Post-Processing profile message
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile (immutable) |
|
deployment_id | string | DeploymentId for which this profile belongs |
|
version | uint32 | Version number of this profile (1 = first) |
|
name | string | Name of this profile |
|
description | string | Optional human-readable description |
|
operations | RegexOperation | repeated | Array of regex operations |
created_at | google.protobuf.Timestamp | When this profile was created |
|
updated_at | google.protobuf.Timestamp | When this profile was updated |
Describes the Regex operation of Post-Processing profile
Field | Type | Label | Description |
index | uint32 | Unique index for ordering |
|
pattern | string | Regex pattern |
|
replacement | string | Replacement string |
|
flags | string | Optional regex flags |
|
description | string | Optional human-readable description |
Request for binary data retrieval
Field | Type | Label | Description |
storage_id | string | Storage identifier for the binary data |
Returns the binary data
Field | Type | Label | Description |
archive_entry | ArchiveEntry | Binary data |
Describes a request for storage identifier
Field | Type | Label | Description |
type | DataType | Data type to be retrieved |
|
hash | string | Hash of the data |
|
session_id | string | Session identifier |
|
channel_id | int32 | Audio channel |
Returns the binary storage UUID
Field | Type | Label | Description |
storage_id | string | Binary storage UUID |
Describes the snapshot data structure
Field | Type | Label | Description |
deployment_id | string | Deployment ID |
|
snapshot_uuid | string | Snapshot UUID (primary key for snapshot database table) |
|
created_date | int64 | Snapshot created (unix timestamp) |
|
component_license_usage | ComponentLicenseUsage | repeated | Usage report snapshot generated at created_date Array of usage report information, one element per component |
Describes Post-Processing profile Update request
Field | Type | Label | Description |
profile_id | string | UUID of the Post-Processing Profile which is being updated |
|
description | string | Optional human-readable description |
|
operations | RegexOperation | repeated | Specify new list of regex operations |
Describes Post-Processing profile Update response
Field | Type | Label | Description |
profile | PostProcessingProfile | Contains requested Post-Processing profile message |
Report request for current transaction usages
Field | Type | Label | Description |
component | string | Optional component filter (all components returned if not specified) |
Returns usage report
Field | Type | Label | Description |
session_ms | uint32 | milliseconds of time (duration) of session/deployment |
|
session_audio_ms | uint32 | milliseconds of audio streamed into session/deployment. |
|
license_usage | UsageReportResponse.LicenseUsageEntry | repeated | map of license usage metadata aggregated for single session. |
Field | Type | Label | Description |
key | string |
|
|
value | ComponentLicenseUsage |
|
UsageSnapshotRequest
Report request for snapshot transaction usages
Field | Type | Label | Description |
component | string | Optional component filter (all components returned if not specified) |
|
start_timestamp | google.protobuf.Timestamp | Starting timestamp for filter |
|
end_timestamp | google.protobuf.Timestamp | Ending timestamp for filter |
Response for snapshot usage
Field | Type | Label | Description |
snapshot_data | SnapshotData | repeated | Array of usage snapshot report information, one element per snapshot Note that each snapshot may contain multiple ComponentData entries |
Describes the possible statuses for an analysis set
Name | Number | Description |
ANALYSIS_SET_STATUS_UNINITIALIZED | 0 | Not yet initialized |
ANALYSIS_SET_STATUS_CREATING | 1 | Create operation is in progress |
ANALYSIS_SET_STATUS_READY | 2 | Created successfully |
ANALYSIS_SET_STATUS_WORKING | 3 | Tuning in progress |
ANALYSIS_SET_STATUS_DELETED | 4 | Deleted |
ANALYSIS_SET_STATUS_ERASING | 5 | Deletion in progress |
ANALYSIS_SET_STATUS_EXPORTING | 6 | Exporting of the analysis set in progress (busy) |
ANALYSIS_SET_STATUS_IMPORTING | 7 | Importing of the analysis set in progress (busy) |
Enum with available sorting fields
Name | Number | Description |
ANALYSIS_SET_LIST_ORDER_CREATED_DATE | 0 | Order by creation date ascending |
ANALYSIS_SET_LIST_ORDER_CREATED_DATE_DESC | 1 | Order by creation date descending |
ANALYSIS_SET_LIST_ORDER_NUM_SESSIONS | 2 | Order by the number of sessions ascending |
ANALYSIS_SET_LIST_ORDER_NUM_SESSIONS_DESC | 3 | Order by the number of sessions descending |
ANALYSIS_SET_LIST_ORDER_NUM_INTERACTIONS | 4 | Order by the number of interactions ascending |
ANALYSIS_SET_LIST_ORDER_NUM_INTERACTIONS_DESC | 5 | Order by the number of interactions descending |
ANALYSIS_SET_LIST_ORDER_STATUS | 6 | Order by interaction status ascending |
ANALYSIS_SET_LIST_ORDER_STATUS_DESC | 7 | Order by interaction status descending |
ANALYSIS_SET_LIST_ORDER_NAME | 8 | Order by interaction name ascending |
ANALYSIS_SET_LIST_ORDER_NAME_DESC | 9 | Order by interaction name descending |
ANALYSIS_SET_LIST_ORDER_TYPE | 10 | Order by interaction type ascending |
ANALYSIS_SET_LIST_ORDER_TYPE_DESC | 11 | Order by interaction type descending |
Data types for binary storage
Name | Number | Description |
DATA_TYPE_UNDEFINED | 0 | Undefined |
DATA_TYPE_AUDIO | 1 | Audio |
DATA_TYPE_MODEL | 2 | Voice print |
DATA_TYPE_FEATURE | 3 | Voice print feature |
DATA_TYPE_HASH | 4 | Audio hash |
DATA_TYPE_SSML | 5 | Ssml |
DATA_TYPE_GRAMMAR | 6 | Grammar |
Define various diagnostics types
Name | Number | Description |
Undefined | 0 | No diagnostic type specified (do not use) |
Postgres | 1 | Postgres diagnostic test specified |
MongoDb | 3 | MongoDB diagnostic test specified |
Redis | 4 | Redis diagnostic test specified |
RabbitMq | 5 | RabbitMQ diagnostic test specified |
Enum with the sorting fields
Name | Number | Description |
INTERACTION_ANALYSIS_LIST_ORDER_START_TIME | 0 | Order by interaction start date ascending |
INTERACTION_ANALYSIS_LIST_ORDER_START_TIME_DESC | 1 | Order by interaction start date descending |
INTERACTION_ANALYSIS_LIST_ORDER_END_TIME | 2 | Order by interaction end date ascending |
INTERACTION_ANALYSIS_LIST_ORDER_END_TIME_DESC | 3 | Order by interaction end date descending Can be extended depending on requirements |
Enum with interaction analysis statuses
Name | Number | Description |
INTERACTION_ANALYSIS_STATUS_NO_TRANSCRIPT | 0 | No transcription |
INTERACTION_ANALYSIS_STATUS_CORRECT | 1 | Correct |
INTERACTION_ANALYSIS_STATUS_INCORRECT | 2 | Incorect |
INTERACTION_ANALYSIS_STATUS_OOG | 3 | Out of Grammar |
INTERACTION_ANALYSIS_STATUS_OOC | 4 | Out of Coverage |
INTERACTION_ANALYSIS_STATUS_SI_MATCH | 5 | SI Match |
INTERACTION_ANALYSIS_STATUS_LOAD_FAILURE | 6 | Failure for load |
INTERACTION_ANALYSIS_STATUS_DECODE_FAILURE | 7 | Failure for decode |
INTERACTION_ANALYSIS_STATUS_NO_INPUT | 8 | No input |
INTERACTION_ANALYSIS_STATUS_CORRECT_NO_INPUT | 9 | No input - correct |
INTERACTION_ANALYSIS_STATUS_INCORRECT_NO_INPUT | 10 | No input - incorrect |
ReportingAPIService
The LumenVox Reporting API can be used to access various reporting resources
Method Name | Request Type | Response Type | Description |
AnalysisSetPreCreate | AnalysisSetPreCreateRequest | AnalysisSetPreCreateResponse | Used to analyze AnalysisSetFilterOptions and to notify user about number of sessions and interactions which are going to be included into analysis. This request is optional, and AnalysisSet can be created without this one being called. |
AnalysisSetCreate | AnalysisSetCreateRequest | AnalysisSetCreateResponse | Creates an analysis set based on the requested filter. There are AnalysisSetFilterOptions as part of request for various filtering adjustments like: start/end time, type, status etc. |
AnalysisSetGet | AnalysisSetGetRequest | AnalysisSetGetResponse | Retrieves analysis set by ID returned from AnalysisSetCreate method call. analysis set can be requested immediately after being created. Check its status field AnalysisSetStatus for creating progress. |
AnalysisSetDelete | AnalysisSetDeleteRequest | AnalysisSetDeleteResponse | Deletes an AnalysisSet |
AnalysisSetList | AnalysisSetListRequest | AnalysisSetListResponse | Returns a list of some of AnalysisSet fields for table view. Classic pagination is used where you need to provide page size and starting point to get only limited data set. |
RetrieveArchiveData | RetrieveArchiveDataRequest | RetrieveArchiveDataResponse | Retrieves data from the archive by its storage_id field. |
RetrieveArchiveDataStream | RetrieveArchiveDataRequest | RetrieveArchiveDataResponse stream | Retrieves stream data from the archive by its storage_id field. |
RetrieveStorageId | RetrieveStorageIdRequest | RetrieveStorageIdResponse | RetrieveStorageId retrieves the storage_id from archive by its hash value. |
InteractionList | InteractionAnalysisListRequest | InteractionAnalysisListResponse | Returns a list of some of interactions within analysis set. Classic pagination is used where you need to provide page size and starting point to get only limited data set. |
InteractionGet | InteractionAnalysisGetRequest | InteractionAnalysisGetResponse | Retrieves one interaction by ID. Interaction can be requested immediately after analysis set is created. |
InteractionUpdate | InteractionAnalysisUpdateTranscriptionRequest | InteractionAnalysisUpdateTranscriptionResponse | Updates the interaction. Interaction can be updated in order to test different parameters setting for interaction processing. |
GetThirdPartyLicenseAttribution | GetThirdPartyLicenseAttributionRequest | GetThirdPartyLicenseAttributionResponse | Returns license file of used third party components |
UsageReport | UsageReportRequest | UsageReportResponse | Returns license usage report for specified deployment |
UsageSnapshot | UsageSnapshotRequest | UsageSnapshotResponse | Returns license usage snapshots for specified deployment in specified period |
LicenseStatusReportResponsePush | LicenseStatusReportResponsePushRequest | LicenseStatusReportResponsePushResponse | Sends lumenvox cloud license server response to license service |
LicenseStatusReportPull | LicenseStatusReportPullRequest | LicenseStatusReportPullResponse | Retrieves license status report from license service |
ExportAnalysisSet | ExportAnalysisSetRequest | ExportAnalysisSetResponse stream | Export analysis set data including audio and grammars. |
ImportAnalysisSet | ImportAnalysisSetRequest stream | ImportAnalysisSetResponse | Import an analysis set from exported data. |
DiagnosticsCheck | DiagnosticsCheckRequest | DiagnosticsCheckResponse | Run various diagnostic checks: postgres, mongodb, redis |
EvaluateTranscription | EvaluateTranscriptionRequest | EvaluateTranscriptionResponse | Performs fuzzy matching on machine and human transcribed texts |
CreatePostProcessingProfile | CreatePostProcessingProfileRequest | CreatePostProcessingProfileResponse | Creates a new Post-Processing Profile within a deployment and returns its server-generated GUID. Request: - CreatePostProcessingProfileRequest: - Includes data needed to define the profile (for example: deployment_id, name, and operations). - Operations are applied in ascending order of their index; index values should be unique within the profile. Response: - CreatePostProcessingProfileResponse: - Contains the GUID (UUID) of the newly created profile (profile_id). Behavior: - The profile name should be unique within the specified deployment. - Implementation will validate the operations list (e.g., non-empty pattern strings). Errors: - INVALID_ARGUMENT: Malformed request (e.g., missing required fields, invalid operations). - NOT_FOUND: Specified deployment does not exist. - ALREADY_EXISTS: A profile with the same name already exists within the deployment. |
GetPostProcessingProfile | GetPostProcessingProfileRequest | GetPostProcessingProfileResponse | Retrieves Post-Processing Profile, specified by id. Request: - GetPostProcessingProfileRequest: - Contains requesting profile ID (profile_id). Response: - GetPostProcessingProfilesResponse: - Contains Post-Processing Profile message. Errors: - INVALID_ARGUMENT: Malformed request (e.g., invalid profile_id UUID string). - NOT_FOUND: Specified profile_id does not exist. |
GetPostProcessingProfiles | GetPostProcessingProfilesRequest | GetPostProcessingProfilesResponse | Retrieves Post-Processing Profiles, filtered by criteria in the request. Request: - GetPostProcessingProfilesRequest: Response: - GetPostProcessingProfilesResponse: - Contains a list of matching Post-Processing Profile(s). Errors: - INVALID_ARGUMENT: Malformed request (e.g., invalid UUID string). |
UpdatePostProcessingProfile | UpdatePostProcessingProfileRequest | UpdatePostProcessingProfileResponse | Updates specified Post-Processing Profile. Request: - UpdatePostProcessingProfileRequest: - Contains profile_id of updating profile and new list of RegexOperations Response: - UpdatePostProcessingProfileResponse: - Contains the updated profile Behavior: - Server-managed fields (profile_id, created_at) are immutable; - A successful update should increment the profile version. Errors: - INVALID_ARGUMENT: Malformed request (e.g., missing profile identifier, invalid operations). - NOT_FOUND: Specified profile do not exist. |
DeletePostProcessingProfile | DeletePostProcessingProfileRequest | DeletePostProcessingProfileResponse | Deletes a Post-Processing Profile identified in the request. Request: - DeletePostProcessingProfileRequest: - Identifies the target profile to delete by profile_id. Response: - DeletePostProcessingProfileResponse: - Confirms the deletion and may include later additional metadata about the deleted profile. Behavior: - The operation removes the specified profile from use. Errors: - INVALID_ARGUMENT: Malformed request (e.g., missing required identifier). - NOT_FOUND: The specified profile does not exist or is already deleted. |
ExportPostProcessingProfile | ExportPostProcessingProfileRequest | ExportPostProcessingProfileResponse | Exports a Post-Processing Profile into a portable representation. Request: - ExportPostProcessingProfileRequest: - Identifies which profile to export. Response: - ExportPostProcessingProfileResponse: - Contains the serialized/portable profile definition suitable for backup, migration, or import. Behavior: - The exported payload should include all data necessary to faithfully recreate the profile, including name, operations (with ordering), and versioning history. Errors: - INVALID_ARGUMENT: Malformed request (e.g., missing identifiers). - NOT_FOUND: The specified profile (or version) does not exist. |
ImportPostProcessingProfile | ImportPostProcessingProfileRequest | ImportPostProcessingProfileResponse | Imports a Post-Processing Profile from a portable representation. Request: - ImportPostProcessingProfileRequest: - Provides the serialized/portable profile definition to import. Response: - ImportPostProcessingProfileResponse: - Returns identifiers for the imported profile (profile_id). Errors: - INVALID_ARGUMENT: Malformed payload or validation errors. - ALREADY_EXISTS: Conflict with an existing profile when overwrite is not allowed. - NOT_FOUND: Referenced deployment does not exist. |
GetPostProcessingProfileHistory | GetPostProcessingProfileHistoryRequest | GetPostProcessingProfileHistoryResponse | Retrieves the full version history of a Post-Processing Profile. Request: - GetPostProcessingProfileHistoryRequest: - Identifies the target profile by profile_id Response: - GetPostProcessingProfileHistoryResponse: - Contains an ordered collection of profile versions (ascending by version number) Behavior: - Returned versions should reflect the exact historical state, including timestamps. Errors: - INVALID_ARGUMENT: Malformed request. - NOT_FOUND: The specified profile does not exist. |
.proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
double | double | double | float | float64 | double | float | Float | |
float | float | float | float | float32 | float | float | Float | |
int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
bool | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass | |
string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |
Copyright (C) 2001-2025, Ai Software, LLC d/b/a LumenVox