Video Intelligence API의 일부 메서드는 장기 실행 작업을 반환합니다. 이러한 메서드는 비동기적이며 메서드가 응답을 반환하면 작업이 완료되지 않을 수 있습니다.
작업 상태 가져오기
작업 이름을 사용해서 장기 실행 작업(장면 변환 감지)의 상태를 확인할 수 있습니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- OPERATION_NAME: 호출로부터 Video Intelligence API로 반환된
name
필드입니다. 이것은 다음 형식의 값입니다.
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
,
각 항목의 의미는 다음과 같습니다.- PROJECT_NUMBER는 Google Cloud 프로젝트의 번호입니다.
- LOCATION_ID는 주석이 발생한 클라우드 리전입니다(예:
us-east1
,us-west1
,europe-west1
,asia-east1
). - OPERATION_ID는 장기 실행 작업의 ID입니다.
HTTP 메서드 및 URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "INPUT_URI", "progressPercent": 100, "startTime": "2020-05-12T19:36:09.110351Z", "updateTime": "2020-05-12T19:36:17.519069Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse", "annotationResults": [ { ... } ] } }
작업 취소
작업 ID를 사용하여 장기 실행 작업을 취소할 수 있습니다. 취소 작업이 반드시 성공하지는 않습니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- OPERATION_ID: 작업을 시작할 때 응답에 제공됩니다.
예를 들면projects/754177431483/locations/us-west1/operations/3326639765503758657
의3326639765503758657
입니다. - 참고:
- PROJECT_NUMBER: GCP 프로젝트 ID
- LOCATION_ID: 주석이 있어야 하는 Cloud 리전입니다. 지원되는 클라우드 리전은
us-east1
,us-west1
,europe-west1
,asia-east1
입니다. 리전을 지정하지 않으면 동영상 파일 위치를 기준으로 리전이 결정됩니다.
HTTP 메서드 및 URL:
POST https://videointelligence.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID:cancel
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.