Index
AutoMl
(interface)PredictionService
(interface)StreamingPredictionService
(interface)AnnotationPayload
(message)AnnotationSpec
(message)BatchPredictInputConfig
(message)BatchPredictOperationMetadata
(message)BatchPredictOperationMetadata.BatchPredictOutputInfo
(message)BatchPredictOutputConfig
(message)BatchPredictRequest
(message)BatchPredictResult
(message)BigQueryDestination
(message)BoundingBoxMetricsEntry
(message)BoundingBoxMetricsEntry.ConfidenceMetricsEntry
(message)BoundingPoly
(message)ClassificationAnnotation
(message)CreateDatasetRequest
(message)CreateModelOperationMetadata
(message)CreateModelRequest
(message)Dataset
(message)DeleteDatasetRequest
(message)DeleteModelRequest
(message)DeleteOperationMetadata
(message)DeployModelOperationMetadata
(message)DeployModelRequest
(message)ExamplePayload
(message)ExportDataOperationMetadata
(message)ExportDataOperationMetadata.ExportDataOutputInfo
(message)ExportDataRequest
(message)GcsDestination
(message)GcsSource
(message)GetAnnotationSpecRequest
(message)GetDatasetRequest
(message)GetModelEvaluationRequest
(message)GetModelRequest
(message)ImportDataOperationMetadata
(message)ImportDataRequest
(message)InputConfig
(message)ListDatasetsRequest
(message)ListDatasetsResponse
(message)ListModelEvaluationsRequest
(message)ListModelEvaluationsResponse
(message)ListModelsRequest
(message)ListModelsResponse
(message)Model
(message)Model.DeploymentState
(enum)ModelEvaluation
(message)NormalizedVertex
(message)OperationMetadata
(message)OutputConfig
(message)PredictRequest
(message)PredictResponse
(message)UndeployModelOperationMetadata
(message)UndeployModelRequest
(message)VideoObjectTrackingAnnotation
(message)VideoObjectTrackingDatasetMetadata
(message)VideoObjectTrackingEvaluationMetrics
(message)VideoObjectTrackingModelMetadata
(message)
AutoMl
API AutoML Server.
Les noms de ressources sont attribués par le serveur. Le serveur ne réutilise jamais les noms qu'il a créés après la suppression des ressources portant ces noms.
L'ID de ressource est la dernière composante du nom de ressource de l'élément. Pour projects/{project_id}/locations/{location_id}/datasets/{dataset_id}
, l'ID de l'élément est {dataset_id}
.
Actuellement, le seul élément location_id
accepté est "us-central1".
Quelle que soit l'entrée documentée pour un paramètre de chaîne attendu dans "snake_case" ou "kebab-case", l'un ou l'autre de ces cas est accepté.
CreateDataset | |
---|---|
Crée un ensemble de données.
|
CreateModel | |
---|---|
Crée un modèle. Renvoie un modèle dans le champ
|
DeleteDataset | |
---|---|
Supprime un ensemble de données et tout son contenu. Renvoie une réponse vide dans le champ
|
DeleteModel | |
---|---|
Supprime un modèle. Renvoie
|
DeployModel | |
---|---|
Déploie un modèle. Renvoie une réponse vide dans le champ
|
ExportData | |
---|---|
Exporte les données de l'ensemble de données vers un emplacement de sortie fourni. Renvoie une réponse vide dans le champ
|
GetAnnotationSpec | |
---|---|
Permet d'obtenir une spécification d'annotation.
|
GetDataset | |
---|---|
Permet d'obtenir un ensemble de données.
|
GetModel | |
---|---|
Permet d'obtenir un modèle.
|
GetModelEvaluation | |
---|---|
Permet d'obtenir une évaluation du modèle.
|
ImportData | |
---|---|
Importe des données dans un ensemble de données. Vous ne pouvez appeler cette méthode que pour un ensemble de données vide. Pour plus d'informations, consultez la section Importer des éléments dans un ensemble de données.
|
ListDatasets | |
---|---|
Répertorie les ensembles de données d'un projet.
|
ListModelEvaluations | |
---|---|
Répertorie les évaluations de modèles.
|
ListModels | |
---|---|
Répertorie les modèles.
|
UndeployModel | |
---|---|
Annule le déploiement d'un modèle. Renvoie une réponse vide dans le champ
|
PredictionService
API AutoML Prediction.
Quelle que soit l'entrée documentée pour un paramètre de chaîne attendu dans "snake_case" ou "kebab-case", l'un ou l'autre de ces cas est accepté.
BatchPredict | |
---|---|
Effectue une prédiction par lot et renvoie l'identifiant d'une opération de longue durée. Vous pouvez demander le résultat de l'opération à l'aide de la méthode
|
Predict | |
---|---|
Non utilisé pour le suivi des objets AutoML Video Intelligence.
|
StreamingPredictionService
API AutoML Streaming Prediction.
Quelle que soit l'entrée documentée pour un paramètre de chaîne attendu dans "snake_case" ou "kebab-case", l'un ou l'autre de ces cas est accepté.
AnnotationPayload
Contient des annotations pertinentes pour AutoML.
Champs | ||
---|---|---|
annotation_spec_id |
Uniquement en sortie. L'ID de ressource de la spécification d'annotation à laquelle cette annotation se rapporte. La spécification d'annotation provient soit d'un ensemble de données ancêtre, soit de l'ensemble de données qui a servi à entraîner le modèle utilisé. |
|
display_name |
Uniquement en sortie. La valeur d' |
|
Champ d'union detail . Uniquement en sortie. Informations supplémentaires sur l'annotation spécifique à la solution AutoML. La valeur detail ne peut être que l'un des éléments suivants : |
||
classification |
Non utilisé pour le suivi des objets AutoML Video Intelligence. |
|
video_object_tracking |
Détails d'annotation pour les prédictions de suivi des objets. |
AnnotationSpec
Définition d'une annotation.
Champs | |
---|---|
name |
Uniquement en sortie. Le nom de ressource de la spécification d'annotation. Format : "projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/annotationSpecs/{annotation_spec_id}" |
display_name |
Obligatoire. Le nom de la spécification d'annotation à afficher dans l'interface. Ce nom peut comporter jusqu'à 32 caractères. Les seuls caractères autorisés sont les lettres de l'alphabet latin ASCII (A-Z et a-z), le trait de soulignement (_) et les chiffres ASCII de 0 à 9. |
example_count |
Uniquement en sortie. Nombre d'exemples dans l'ensemble de données parent étiqueté par la spécification d'annotation. |
BatchPredictInputConfig
Configuration d'entrée pour l'action BatchPredict
. L'entrée est un ou plusieurs fichiers CSV stockés dans Google Cloud Storage, où les fichiers CSV sont au format suivant :
GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END
GCS_FILE_PATH
identifie le chemin d'accès Google Cloud Storage à une vidéo d'une taille maximale de 50 Go et d'une durée maximale de 3 h. Extensions compatibles : .MOV, .MPEG4, .MP4, .AVI.Les valeurs
TIME_SEGMENT_START
etTIME_SEGMENT_END
doivent être comprises entre le début et la fin de la vidéo, et la fin doit être postérieure au début.
Trois lignes d'exemple :
gs://folder/video1.mp4,10,40
gs://folder/video1.mp4,20,60
gs://folder/vid2.mov,0,inf
Consultez la section Annoter des vidéos pour plus d'informations.
Champs | |
---|---|
gcs_source |
Emplacement Google Cloud Storage pour le contenu d'entrée |
BatchPredictOperationMetadata
Détails d'une opération de prédiction par lot (BatchPredict).
Champs | |
---|---|
input_config |
Uniquement en sortie. La configuration d'entrée qui a été définie au démarrage de cette opération de prédiction par lot. |
output_info |
Uniquement en sortie. Informations détaillées sur le résultat de cette opération de prédiction par lot. |
BatchPredictOutputInfo
Fournit des informations détaillées sur le résultat de cette opération de prédiction par lot. Complète
[BatchPredictionOutputConfig][google.cloud.automl.v1beta1.BatchPredictionOutputConfig].
Champs | ||
---|---|---|
Champ d'union output_location . L'emplacement de sortie dans lequel la sortie de prédiction est écrite. output_location ne peut être que l'un des éléments suivants : |
||
gcs_output_directory |
Chemin d'accès complet au répertoire Google Cloud Storage créé, dans lequel le résultat de la prédiction est écrit. |
|
bigquery_output_dataset |
Chemin d'accès à l'ensemble de données BigQuery créé, au format bq://projectId.bqDatasetId, dans lequel le résultat de la prédiction est écrit. |
BatchPredictOutputConfig
Configuration de sortie pour l'action BatchPredict
.
AutoML Video Intelligence crée un répertoire spécifié dans [gcsDestination
][google.cloud.automl.v1beta1.BatchPredictionOutputConfig.gcs_destination]. Le nom du répertoire est "prediction-<model-display-name>-<timestamp-of-prediction-call>", où l'horodatage est au format ISO-8601 YYYY-MM-DDThh:mm:ss.sssZ
.
AutoML Video Intelligence crée un fichier nommé "video_classification.csv" dans le nouveau répertoire, ainsi qu'un fichier JSON pour chaque classification de vidéos demandée, autrement dit, pour chaque ligne du fichier CSV d'entrée.
Le format du fichier "video_classification.csv" est le suivant :
GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END,JSON_FILE_NAME,STATUS
Les éléments
GCS_FILE_PATH
,TIME_SEGMENT_START
etTIME_SEGMENT_END
correspondent aux mêmes champs du fichier CSV d'entrée.JSON_FILE_NAME
est le nom du fichier JSON du répertoire de sortie contenant les réponses de prédiction pour le segment temporel de la vidéo.STATUS
contient "OK" si la prédiction a bien été exécutée ; si ce n'est pas le cas, ce champ contient des informations d'erreur. SiSTATUS
n'indique pas "OK", le fichier JSON de cette prévision peut être vide ou le fichier peut ne pas exister.
Chaque fichier JSON dont le champ STATUS
indique l'état "OK" contient une liste de protos "AnnotationPayload" au format JSON, qui sont les prédictions du segment temporel de la vidéo auquel le fichier est attribué dans le fichier "video_classification.csv". Tous les protos "AnnotationPayload" contiennent un champ video_classification
et sont triés par le champ video_classification.type
. Les types renvoyés sont déterminés par le paramètre classifaction_types
de BatchPredictRequest.params
.
Champs | ||
---|---|---|
Champ d'union destination . Obligatoire. Destination de la sortie. destination ne peut être que l'un des éléments suivants : |
||
gcs_destination |
Emplacement Google Cloud Storage du répertoire dans lequel la sortie doit être écrite. |
|
bigquery_destination |
Emplacement BigQuery dans lequel la sortie doit être écrite. |
BatchPredictRequest
Message de requête pour PredictionService.BatchPredict
.
Champs | |||||||||
---|---|---|---|---|---|---|---|---|---|
name |
Le nom du modèle demandé pour les besoins de la prédiction par lot. L'autorisation Google IAM suivante est requise pour la ressource
|
||||||||
input_config |
Obligatoire. La configuration d'entrée pour la prédiction par lot. |
||||||||
output_config |
Obligatoire. La configuration spécifiant où les prédictions de sortie doivent être écrites. |
||||||||
params |
Les possibilités suivantes s'offrent à vous :
Consultez la section Annoter des vidéos pour plus de détails. |
BatchPredictResult
Résultat de la prédiction par lot.
Champs | |
---|---|
metadata |
Métadonnées de réponse de prédiction supplémentaires spécifiques à un domaine. |
BigQueryDestination
Non utilisé pour le suivi des objets AutoML Video Intelligence.
Champs | |
---|---|
output_uri |
Obligatoire. URI BigQuery d'un projet, 2 000 caractères au maximum. Formes acceptées : * chemin BigQuery, par exemple bq://projectId. |
BoundingBoxMetricsEntry
Métriques du modèle de correspondance du cadre de délimitation pour un seuil unique "intersection-over-union" (ratio entre l'aire d'intersection et l'aire d'union) et plusieurs seuils de confiance pour la correspondance des étiquettes.
Champs | |
---|---|
iou_threshold |
Uniquement en sortie. Valeur du seuil "intersection-over-union" (ratio entre l'aire d'intersection et l'aire d'union) utilisé pour calculer cette entrée de métrique. |
mean_average_precision |
Uniquement en sortie. Précision moyenne, le plus souvent proche de "au_prc". |
confidence_metrics_entries[] |
Uniquement en sortie. Métriques associées à chaque seuil de confiance ("confidence_threshold") pour la correspondance des étiquettes à partir de 0,05, 0,10, …, 0,95, 0,96, 0,97, 0,98, 0,99. La courbe de précision/rappel en est dérivée. |
ConfidenceMetricsEntry
Métriques pour un seul seuil de confiance.
Champs | |
---|---|
confidence_threshold |
Uniquement en sortie. Valeur du seuil de confiance utilisée pour calculer les métriques. |
recall |
Uniquement en sortie. Rappel sous le seuil de confiance fixé. |
precision |
Uniquement en sortie. Précision sous le seuil de confiance fixé. |
f1_score |
Uniquement en sortie. La moyenne harmonique du rappel et de la précision. |
BoundingPoly
Polygone de délimitation d'un objet détecté dans un plan. En sortie, les sommets ("vertices") et les sommets normalisés ("normalized_vertices") sont fournis. Le polygone est formé en reliant les sommets dans l'ordre dans lequel ils sont répertoriés.
Champs | |
---|---|
normalized_vertices[] |
Uniquement en sortie. Sommets normalisés du polygone de sélection. |
ClassificationAnnotation
Contient des détails d'annotation spécifiques à la classification.
Champs | |
---|---|
score |
Uniquement en sortie. Estimation du niveau de confiance comprise entre 0,0 et 1,0. Une valeur supérieure indique une plus grande confiance dans le fait que l'annotation est positive. Si un utilisateur approuve le caractère négatif ou positif d'une annotation, la valeur "score" reste inchangée. Si un utilisateur crée une annotation, le score est 0 si elle est négative, et 1 si elle est positive. |
CreateDatasetRequest
Message de requête pour AutoMl.CreateDataset
.
Champs | |
---|---|
parent |
Nom de ressource du projet pour lequel l'ensemble de données doit être créé. L'autorisation Google IAM suivante est requise pour la ressource
|
dataset |
L'ensemble de données à créer. |
CreateModelOperationMetadata
Détails d'une opération de création de modèle (CreateModel).
CreateModelRequest
Message de requête pour AutoMl.CreateModel
.
Champs | |
---|---|
parent |
Nom de ressource du projet parent dans lequel le modèle est créé. L'autorisation Google IAM suivante est requise pour la ressource
|
model |
Le modèle à créer. |
Ensemble de données
Espace de travail pour résoudre un problème de machine learning (ML) unique et spécifique. Un espace de travail contient des exemples pouvant être annotés.
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'ensemble de données. Format : |
display_name |
Obligatoire. Le nom de l'ensemble de données à afficher dans l'interface. Ce nom peut comporter jusqu'à 32 caractères. Les seuls caractères autorisés sont les lettres de l'alphabet latin ASCII (A-Z et a-z), le trait de soulignement (_) et les chiffres ASCII de 0 à 9. |
example_count |
Uniquement en sortie. Le nombre d'exemples dans l'ensemble de données. |
create_time |
Uniquement en sortie. Horodatage de la création de cet ensemble de données. |
video_object_tracking_dataset_metadata |
Métadonnées d'un ensemble de données utilisé pour le suivi des objets vidéo. |
DeleteDatasetRequest
Message de requête pour AutoMl.DeleteDataset
.
Champs | |
---|---|
name |
Nom de ressource de l'ensemble de données à supprimer. L'autorisation Google IAM suivante est requise pour la ressource
|
DeleteModelRequest
Message de requête pour AutoMl.DeleteModel
.
Champs | |
---|---|
name |
Nom de ressource du modèle en cours de suppression. L'autorisation Google IAM suivante est requise pour la ressource
|
DeleteOperationMetadata
Détails des opérations de suppression d'entités.
DeployModelOperationMetadata
Détails de l'opération de déploiement de modèle (DeployModel).
DeployModelRequest
Message de requête pour AutoMl.DeployModel
.
Champs | |
---|---|
name |
Nom de ressource du modèle à déployer. L'autorisation Google IAM suivante est requise pour la ressource
|
ExamplePayload
Exemple de données utilisées pour l'entraînement ou la prédiction.
ExportDataOperationMetadata
Détails d'une opération d'exportation de données (ExportData).
Champs | |
---|---|
output_info |
Uniquement en sortie. Informations détaillées sur le résultat de l'exportation de données. |
ExportDataOutputInfo
Fournit des informations détaillées sur le résultat de l'exportation de données. Complète OutputConfig
.
Champs | ||
---|---|---|
Champ d'union output_location . L'emplacement de sortie dans lequel les données exportées sont écrites. output_location ne peut être que l'un des éléments suivants : |
||
gcs_output_directory |
Chemin d'accès complet au répertoire Google Cloud Storage créé, dans lequel les données exportées sont écrites. |
|
bigquery_output_dataset |
Chemin d'accès à l'ensemble de données BigQuery créé, au format bq://projectId.bqDatasetId, dans lequel les données exportées sont écrites. |
ExportDataRequest
Message de requête pour AutoMl.ExportData
.
Champs | |
---|---|
name |
Obligatoire. Nom de ressource de l'ensemble de données. L'autorisation Google IAM suivante est requise pour la ressource
|
output_config |
Obligatoire. L'emplacement de sortie souhaité. |
GcsDestination
Emplacement Google Cloud Storage dans lequel la sortie doit être écrite.
Champs | |
---|---|
output_uri_prefix |
Obligatoire. URI Google Cloud Storage du répertoire de sortie, 2 000 caractères au maximum. Formes acceptées : * Chemin du préfixe : gs://bucket/directory. L'utilisateur à l'origine de la requête doit disposer de l'autorisation en écriture sur le bucket. Le répertoire est créé s'il n'existe pas. |
GcsSource
L'emplacement Google Cloud Storage pour le contenu d'entrée.
Champs | |
---|---|
input_uris[] |
Obligatoire. URI Google Cloud Storage des fichiers d'entrée, 2 000 caractères au maximum. Formes acceptées : * Chemin complet de l'objet, par exemple gs://bucket/directory/object.csv |
GetAnnotationSpecRequest
Message de requête pour AutoMl.GetAnnotationSpec
.
Champs | |
---|---|
name |
Nom de ressource de la spécification d'annotation à récupérer. L'autorisation Google IAM suivante est requise pour la ressource
|
GetDatasetRequest
Message de requête pour AutoMl.GetDataset
.
Champs | |
---|---|
name |
Nom de ressource de l'ensemble de données à récupérer. L'autorisation Google IAM suivante est requise pour la ressource
|
GetModelEvaluationRequest
Message de requête pour AutoMl.GetModelEvaluation
.
Champs | |
---|---|
name |
Nom de ressource pour l'évaluation du modèle. L'autorisation Google IAM suivante est requise pour la ressource
|
GetModelRequest
Message de requête pour AutoMl.GetModel
.
Champs | |
---|---|
name |
Nom de ressource du modèle. L'autorisation Google IAM suivante est requise pour la ressource
|
ImportDataOperationMetadata
Détails d'une opération d'importation de données (ImportData).
ImportDataRequest
Message de requête pour AutoMl.ImportData
.
Champs | |
---|---|
name |
Obligatoire. Nom de l'ensemble de données. L'ensemble de données doit déjà exister. Toutes les annotations et exemples importés seront ajoutés. L'autorisation Google IAM suivante est requise pour la ressource
|
input_config |
Obligatoire. L'emplacement d'entrée souhaité et sa sémantique spécifique au domaine, le cas échéant. |
InputConfig
Configuration d'entrée pour l'action ImportData
.
Le format de l'entrée dépend des métadonnées "dataset_metadata" de l'ensemble de données dans lequel l'importation est effectuée. La source gcs_source
est attendue en tant que source d'entrée, sauf indication contraire. Si un fichier dont le contenu est identique (même si son chemin GCS_FILE_PATH
est différent) est mentionné à plusieurs reprises, son étiquette, ses cadres de délimitation, etc., sont ajoutés. Un même fichier devrait toujours être fourni avec les mêmes champs ML_USE
et GCS_FILE_PATH
. Si ce n'est pas le cas, ces valeurs sont sélectionnées de manière non déterministe parmi les valeurs fournies.
Les formats sont représentés en EBNF (BNF étendu), avec des virgules sous forme littérale et les symboles non terminaux définis vers la fin de ce commentaire. Les formats sont :
Pour en savoir plus, consultez la page Préparer les données d'entraînement.
Fichier(s) CSV avec chaque ligne au format :
ML_USE,GCS_FILE_PATH
ML_USE
– Identifie l'ensemble de données auquel la ligne actuelle (fichier) s'applique. Cette valeur peut être l'une des suivantes :TRAIN
– Les lignes de ce fichier sont utilisées pour entraîner le modèle.TEST
– Les lignes de ce fichier sont utilisées pour tester le modèle pendant l'entraînement.UNASSIGNED
– Les lignes de ce fichier ne sont pas catégorisées. Elles sont automatiquement divisées en données d'entraînement et de test (80 % pour l'entraînement et 20 % pour les tests).
GCS_FILE_PATH
– Identifie un fichier stocké dans Google Cloud Storage contenant les informations relatives à l'entraînement du modèle.
Une fois que l'ensemble de données d'entraînement a été déterminé à partir des fichiers CSV TRAIN
et UNASSIGNED
, les données d'entraînement sont réparties entre l'ensemble de données d'entraînement et l'ensemble de données de validation (70 % pour l'entraînement et 30 % pour la validation).
Chaque fichier CSV spécifié à l'aide du champ GCS_FILE_PATH
a le format suivant :
GCS_FILE_PATH,LABEL,TIME_SEGMENT_START,TIME_SEGMENT_END
GCS_FILE_PATH
– Le chemin d'accès à une vidéo stockée dans Google Cloud Storage. Durée de la vidéo : jusqu'à 60 minutes. Extensions compatibles : .MOV, .MPEG4, .MP4, .AVI et tout format de fichier compatible avec ffmpeg.LABEL
– Une étiquette qui identifie l'objet du segment vidéo.TIME_SEGMENT_START
etTIME_SEGMENT_END
– Les horodatages (heures de début et de fin) en secondes du segment vidéo à annoter. Ces valeurs doivent être comprises entre le début et la fin de la vidéo, etTIME_SEGMENT_END
doit être postérieur àTIME_SEGMENT_START
.
Toute image d'une vidéo associée à une ou plusieurs étiquettes est considérée comme un négatif fort pour toutes les autres étiquettes. Une image sans étiquette par défaut est considérée comme inconnue (peut être ignorée à l'aide du paramètre is_exhaustively_labeled
). Une étiquette spéciale "-" permet d'indiquer qu'un segment de temps donné est un élément négatif fort pour toutes les étiquettes. Les segments marqués "-" ne peuvent pas chevaucher les segments d'une autre étiquette.
Exemple de fichier :
TRAIN,gs:folder/train_videos.csv
TEST,gs:folder/test_videos.csv
UNASSIGNED,gs:folder/other_videos.csv
L'exemple ci-dessous montre le format de l'un des fichiers CSV identifiés par le fichier de niveau supérieur gcsSource
.
gs:folder/video1.avi,car,120,180.000021
gs:folder/video1.avi,bike,150,180.000023
gs:folder/video1.avi,-,180.000024,300.000999
gs:folder/vid2.avi,car,0,60.5
Erreurs :
Si l'un des fichiers CSV fournis ne peut pas être analysé ou s'il est impossible de traiter plus d'un certain pourcentage de lignes CSV, l'opération échoue et rien n'est importé. Indépendamment du succès ou de l'échec global, les échecs par ligne seront répertoriés dans "Operation.metadata.partial_failures" (jusqu'à un certain plafond de dénombrement).
Champs | |
---|---|
gcs_source |
Emplacement Google Cloud Storage pour le contenu d'entrée. |
ListDatasetsRequest
Message de requête pour AutoMl.ListDatasets
.
Champs | |
---|---|
parent |
Nom de ressource du projet à partir duquel les ensembles de données doivent être répertoriés. L'autorisation Google IAM suivante est requise pour la ressource
|
filter |
Expression pour filtrer les résultats de la requête.
Exemple d'utilisation du filtre :
|
page_size |
Taille de la page demandée. Le serveur peut renvoyer un nombre de résultats inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une taille par défaut. |
page_token |
Jeton identifiant une page de résultats que le serveur doit renvoyer. Généralement obtenu via le paramètre |
ListDatasetsResponse
Message de réponse pour AutoMl.ListDatasets
.
Champs | |
---|---|
datasets[] |
Les ensembles de données lues. |
next_page_token |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur à |
ListModelEvaluationsRequest
Message de requête pour AutoMl.ListModelEvaluations
.
Champs | |
---|---|
parent |
Nom de ressource du modèle pour lequel les évaluations de modèle doivent être répertoriées. Si modelId est défini sur "-", les évaluations de modèle de tous les modèles de l'emplacement parent seront répertoriées. L'autorisation Google IAM suivante est requise pour la ressource
|
filter |
Expression pour filtrer les résultats de la requête.
Exemples d'utilisation du filtre :
|
page_size |
Taille de la page demandée. |
page_token |
Jeton identifiant une page de résultats que le serveur doit renvoyer. Généralement obtenu via le paramètre |
ListModelEvaluationsResponse
Message de réponse pour AutoMl.ListModelEvaluations
.
Champs | |
---|---|
model_evaluation[] |
Liste des évaluations de modèles dans la page demandée. |
next_page_token |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur au champ |
ListModelsRequest
Message de requête pour AutoMl.ListModels
.
Champs | |
---|---|
parent |
Nom de ressource du projet à partir duquel les modèles doivent être répertoriés. L'autorisation Google IAM suivante est requise pour la ressource
|
filter |
Expression pour filtrer les résultats de la requête.
Exemples d'utilisation du filtre :
|
page_size |
Taille de la page demandée. |
page_token |
Jeton identifiant une page de résultats que le serveur doit renvoyer. Généralement obtenu via le paramètre |
ListModelsResponse
Message de réponse pour AutoMl.ListModels
.
Champs | |
---|---|
model[] |
Liste des modèles dans la page demandée. |
next_page_token |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur à |
Model
Fichier "API.proto" représentant un modèle de machine learning entraîné.
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource du modèle. Format : |
display_name |
Obligatoire. Le nom du modèle à afficher dans l'interface. Ce nom peut comporter jusqu'à 32 caractères. Les seuls caractères autorisés sont les lettres de l'alphabet latin ASCII (A-Z et a-z), le trait de soulignement (_) et les chiffres ASCII de 0 à 9. Il doit commencer par une lettre. |
dataset_id |
Obligatoire. ID de ressource de l'ensemble de données utilisé pour créer le modèle. L'ensemble de données doit provenir du même projet et du même emplacement ancêtres. |
create_time |
Uniquement en sortie. Horodatage de la création de ce modèle. |
update_time |
Uniquement en sortie. Horodatage de la dernière mise à jour de ce modèle. |
deployment_state |
Uniquement en sortie. État de déploiement du modèle. Un modèle ne peut diffuser des requêtes de prédiction qu'après son déploiement. |
video_object_tracking_model_metadata |
Métadonnées pour les modèles du suivi des objets vidéo. |
DeploymentState
État de déploiement du modèle.
Énumérations (Enums) | |
---|---|
DEPLOYMENT_STATE_UNSPECIFIED |
Ne pas utiliser ce type. Il s'agit de la valeur par défaut attribuée à une énumération non définie. |
DEPLOYED |
Le modèle est déployé. |
UNDEPLOYED |
Le modèle n'est pas déployé. |
ModelEvaluation
Résultats d'évaluation d'un modèle.
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'évaluation du modèle. Format :
|
annotation_spec_id |
Uniquement en sortie. ID de la spécification d'annotation à laquelle l'évaluation du modèle s'applique. L'ID est vide pour l'évaluation globale du modèle. Pour la classification des tables, il s'agit des valeurs distinctes de la colonne cible au moment de l'évaluation. Dans ce cas, les spécifications d'annotation dans l'ensemble de données n'existent pas. REMARQUE : Il n'existe actuellement aucun moyen d'obtenir le nom à afficher "display_name" de la spécification d'annotation à partir de son ID. Pour voir les noms à afficher, consultez les évaluations du modèle dans l'interface utilisateur. |
display_name |
Uniquement en sortie. La valeur d' |
create_time |
Uniquement en sortie. Horodatage de la création de cette évaluation de modèle. |
evaluated_example_count |
Uniquement en sortie. Nombre d'exemples utilisés pour l'évaluation du modèle, c'est-à-dire pour lesquels la situation réelle du moment de la création du modèle est comparée aux annotations prévues créées par le modèle. Pour le champ "ModelEvaluation" global (c'est-à-dire avec le champ "annotation_spec_id" non défini), il s'agit du nombre total de tous les exemples utilisés pour l'évaluation. Sinon, il s'agit du nombre d'exemples qui ont été réellement annotés par |
video_object_tracking_evaluation_metrics |
Métriques d'évaluation pour les modèles de suivi des objets. |
NormalizedVertex
Un sommet représente un point 2D dans l'image. Les coordonnées des sommets normalisés sont comprises entre 0 et 1 fraction par rapport au plan d'origine (image, vidéo). Par exemple, si le plan (par exemple, l'image entière) a une taille de 10 x 20, un point avec des coordonnées normalisées (0,1/0,3) est à la position (1, 6) sur ce plan.
Champs | |
---|---|
x |
Obligatoire. Coordonnée horizontale. |
y |
Obligatoire. Coordonnée verticale. |
OperationMetadata
Métadonnées utilisées dans toutes les opérations de longue durée renvoyées par l'API AutoML.
Champs | ||
---|---|---|
progress_percent |
Uniquement en sortie. Progression de l'opération. Plage : [0, 100]. Champ non utilisé à l'heure actuelle. |
|
partial_failures[] |
Uniquement en sortie. Échecs partiels rencontrés. Par exemple, certains fichiers ne peuvent pas être lus. Ce champ ne doit jamais dépasser 20 entrées. Le champ des informations d'état Status.details contient des détails relatifs aux erreurs GCP standards. |
|
create_time |
Uniquement en sortie. Date/heure de création de l'opération. |
|
update_time |
Uniquement en sortie. Date/heure de la dernière mise à jour de l'opération. |
|
Champ d'union details . Uniquement en sortie. Détails de l'opération spécifique. Même si ce champ est vide, sa présence permet de distinguer différents types d'opérations. La valeur details ne peut être que l'un des éléments suivants : |
||
delete_details |
Détails d'une opération de suppression (Delete). |
|
deploy_model_details |
Détails d'une opération de déploiement de modèle (DeployModel). |
|
undeploy_model_details |
Détails d'une opération d'annulation de déploiement du modèle (UndeployModel). |
|
create_model_details |
Détails d'une opération de création de modèle (CreateModel). |
|
import_data_details |
Détails d'une opération d'importation de données (ImportData). |
|
batch_predict_details |
Détails d'une opération de prédiction par lot (BatchPredict). |
|
export_data_details |
Détails d'une opération d'exportation de données (ExportData). |
OutputConfig
Configuration de sortie pour ExportData.
En tant que destination, gcs_destination
doit être défini, sauf indication contraire pour un domaine. Seules les annotations réelles sont exportées (les annotations non approuvées ne sont pas exportées).
Les sorties correspondent à la manière dont les données ont été importées et peuvent être utilisées comme entrées pour importer des données. Les formats de sortie sont représentés au format EBNF avec des virgules sous forme littérale, et les mêmes définitions de symboles non terminaux sont celles des données d'importation InputConfig
.
Il s'agit d'un fichier CSV video_object_tracking.csv
, avec chaque ligne au format suivant et pouvant comporter plusieurs lignes pour un seul élément ML_USE
:
ML_USE,GCS_FILE_PATH
Chaque chemin d'accès GCS_FILE_PATH mène à un autre fichier .csv qui décrit des exemples qui ont obtenu ML_USE
en utilisant le format de ligne suivant :
GCS_FILE_PATH,LABEL,INSTANCE_ID,TIMESTAMP,BOUNDING_BOX
Ici, les données de la colonne GCS_FILE_PATH
pointent vers les emplacements sources originaux des vidéos importées.
Champs | ||
---|---|---|
Champ d'union destination . Obligatoire. Destination de la sortie. destination ne peut être que l'un des éléments suivants : |
||
gcs_destination |
Emplacement Google Cloud Storage dans lequel la sortie doit être écrite. Pour le suivi des objets vidéo, un nouveau répertoire est créé dans le répertoire indiqué, de la même manière que l'horodatage au format ISO-8601 : YYYY-MM-DDThh:mm:ss.sssZ.
Toutes les sorties exportées sont écrites dans ce répertoire. |
|
bigquery_destination |
Emplacement BigQuery dans lequel la sortie doit être écrite. |
PredictRequest
Message de requête pour PredictionService.Predict
.
Champs | |
---|---|
name |
Le nom du modèle demandé pour les besoins de la prédiction. L'autorisation Google IAM suivante est requise pour la ressource
|
payload |
Obligatoire. Charge utile sur laquelle une prédiction doit être effectuée. La charge utile doit correspondre au type de problème pour lequel le modèle a été entraîné. |
params |
Paramètres supplémentaires spécifiques au domaine : la longueur d'une chaîne ne doit pas dépasser 25 000 caractères. |
PredictResponse
Message de réponse pour PredictionService.Predict
.
Champs | |
---|---|
payload[] |
Résultat de la prédiction. |
metadata |
Métadonnées de réponse de prédiction supplémentaires spécifiques à un domaine. |
UndeployModelOperationMetadata
Détails de l'opération d'annulation du déploiement du modèle (UndeployModel).
UndeployModelRequest
Message de requête pour AutoMl.UndeployModel
.
Champs | |
---|---|
name |
Nom de ressource du modèle dont le déploiement doit être annulé. L'autorisation Google IAM suivante est requise pour la ressource
|
VideoObjectTrackingAnnotation
Détails d'annotation pour le suivi des objets vidéo.
Champs | |
---|---|
instance_id |
Facultatif. L'instance de l'objet, exprimée sous la forme d'un entier positif. Utilisé pour faire la distinction entre les objets du même type (par exemple, AnnotationSpec) lorsque plusieurs objets sont présents dans un même exemple. REMARQUE : La qualité de la prédiction d'ID d'instance ne fait pas partie de l'évaluation du modèle et répond à un objectif d'optimisation. C'est particulièrement le cas lorsqu'une entité quitte l'écran pendant une période prolongée (minutes) : à son retour, un nouvel ID d'instance peut lui être attribué. |
time_offset |
Obligatoire. Heure (image) d'une vidéo à laquelle cette annotation appartient. Représenté par la durée écoulée depuis le début de la vidéo. |
bounding_box |
Obligatoire. Rectangle représentant l'emplacement de l'objet sur l'image (c'est-à-dire le décalage ou la valeur "time_offset" de la vidéo). |
score |
Uniquement en sortie. Niveau de confiance indiquant que cette annotation est positive pour la vidéo selon la valeur de décalage ("time_offset") ; valeur spécifiée avec [0, 1] ; une valeur élevée signifie un niveau de confiance accru. Pour les annotations créées par l'utilisateur, le score est 1. Lorsque l'utilisateur approuve une annotation, le score d'origine indiqué avec un nombre à virgule flottante est conservé (et non remplacé par 1). |
VideoObjectTrackingDatasetMetadata
Métadonnées de l'ensemble de données spécifiques au suivi des objets vidéo.
VideoObjectTrackingEvaluationMetrics
Métriques d'évaluation du modèle pour les problèmes liés au suivi des objets vidéo. Évalue la qualité de la prédiction des cadres de délimitation étiquetés et des titres étiquetés (c'est-à-dire une série de cadres de délimitation partageant la même étiquette et le même ID d'instance).
Champs | |
---|---|
evaluated_frame_count |
Uniquement en sortie. Nombre d'images vidéo utilisées pour créer cette évaluation. |
evaluated_bounding_box_count |
Uniquement en sortie. Nombre total de cadres de délimitation (c'est-à-dire ajoutés sur toutes les images) réellement utilisés pour créer cette évaluation. |
evaluated_track_count |
Uniquement en sortie. Nombre total de titres (c'est-à-dire observés dans toutes les images) réellement utilisés pour créer cette évaluation. |
bounding_box_metrics_entries[] |
Uniquement en sortie. Métriques de correspondance des cadres de délimitation pour chaque seuil "intersection-over-union" (ratio entre l'aire d'intersection et l'aire d'union) : 0,05, 0,10, ..., 0,95, 0,96, 0,97, 0,98, 0,99 et pour chaque pair associé au seuil de confiance de l'étiquette : 0,05, 0,10, ..., 0,95, 0,96, 0,97, 0,98, 0,99. |
bounding_box_mean_average_precision |
Uniquement en sortie. Métrique unique pour l'évaluation des cadres de délimitation : précision moyenne ("mean_average_precision") sur toutes les entrées de métriques du cadre de délimitation ("bounding_box_metrics_entries"). |
VideoObjectTrackingModelMetadata
Métadonnées de modèle spécifiques au suivi des objets vidéo.