빠른 시작: 동적 인제스트 API

빠른 시작: Dynamic Ingest API

이 빠른 시작은 다음을 사용하여 비디오 클라우드에 비디오를 추가하는 과정을 안내합니다. Dynamic Ingest API CURL을 통해.

서문

Dynamic Ingest API로 여러 작업을 수행 할 수 있지만 주요 기능은 Video Cloud에 비디오를 추가하는 것입니다. 이 빠른 시작은 API를 사용하여 첫 번째 비디오를 수집하는 과정을 안내하는 간단한 자습서를 제공합니다.

이 자습서에서는 HTTP 요청을 만들기 위해 CURL이라는 인기있는 명령 줄 도구를 사용합니다. CURL에 익숙하지 않은 경우 CURL 설정을 참조하십시오 . CURL은 기본적으로 설치되며 Mac 및 Linux 시스템입니다. Windows에서는 설치해야합니다. 지침은 CURL 설정 가이드에 있습니다.

단계

클라이언트 자격 증명 가져오기

이는 API 요청에 대한 클라이언트 자격 증명을 만드는 일회성 단계입니다. 필요한 클라이언트 자격 증명이 이미있는 경우이 단계를 건너 뛸 수 있습니다.

Studio의 API 자격 증명관리섹션으로 이동합니다.
새 애플리케이션등록을 클릭합니다.
적절한 계정을 선택하고최소한다음 권한을 선택합니다.
- 동적 수집 생성
- 수집 프로필 구성 읽기
- 수집 프로필 읽기
생성된클라이언트 ID와클라이언트 암호를복사하여 저장합니다 (대화 상자를 닫으면 클라이언트 암호를 다시 가져올 방법이 없습니다!).

OAuth 토큰 받기

client_id및client_secret는 후속 요청을 인증하는 데 사용되는 토큰 (기본 인증) 을 가져오기 위한 사용자 이름 및 암호로 사용됩니다.

아래 코드를 텍스트 편집기에 복사하고 및 를 자신의 클라이언트 자격 증명으로CLIENT_ID바꾸십시오. CLIENT_SECRET

    curl --request POST \
    --url https://oauth.brightcove.com/v4/access_token \
    --user CLIENT_ID:CLIENT_SECRET \
    --header 'content-type: application/x-www-form-urlencoded' \
    --data grant_type=client_credentials

이제 코드는 다음과 같습니다.

    curl --request POST \
    --url https://oauth.brightcove.com/v4/access_token \
    --user 0072bebf-0616-442c-84de-7215bb176061:7M0vMete8vP_Dmb9o4a16iws4RQR74PO-JNDKkCOyXFkSIe_iRKdHiiNO6vuBWadn5xFw \
    --header 'content-type: application/x-www-form-urlencoded' \
    --data grant_type=client_credentials

수정 된 코드를 복사하여 터미널 (또는 명령 줄 앱)에 붙여넣고 Return 키를 눌러 실행합니다.

응답은 다음과 같아야합니다.

    {
      "access_token":"AMv4uy9puUMrSPtfOUo412Euy8gY1pcjv6RozlH9ALrHyekxY_u-83KWMECgigG9u_gSQoh_gpe8ChAQ1FHclNHgU4h_2qj-8ei19Ve-m4OJ2UOmJwJBZQht_6bIMJMZUZBIvIAGT-8av-uMOpqnnXVJ1qu2rPQeGraIjEkhTnXnGaa-RNUxisRkIoIktN1o9BFzrbLa1xstvPgVhdg78uVg8uDA8X0K9kfibxBfdIkDBzKJAViZZ3gQa56uit2r79GZ_t2KSUgLq1rOPsd0TflHwCAGtSaAHlvb44m-hUKFAOJa-FtXakQ72QcIXha5PhSjYTJZiUa4EbjxXpR6aLvPW4mGQcDzo8bQQ4Hnq8bsa_8l5eUjOm51WI96WhTPJCt4bBWVJKyLM8P7va_Ho6zJc2yOJHDamilRlyOS-DxN4U30m_2AxhHF3DKJO8fWl5srtpbZRPANOq5B6cpAkOiQafoXUv0ntP9nzRwyO-oXVvH4iLDTAArOTXPh-A7OD8QogWu9wb13vO48CvRPsGv9PfT4ZCxzUa3M2NXn8wontkSARzHVNqf6fh-iF6ifalPTw-Z9MhpPd-qwpcHbJfmu5EcJAR3K3QDYttjeRrmEvTBOgbQttapvI2h6rMQqgytiHXpxYgz3Hr1yKe1cuVI8z3haT5pb-FIfOfHKyr7vQ3RDXjdTTJZMYpOhKNjL0oEH2ev_bIGmbGnqUMcuAGhQgMiCVQUKwoLUGHTRG91ZWMCP7CfTEdcVc10jDSELcZ1SBig5_G42ymv1w3KauK6ZwE_Xmu4NrPZiPo-r3u_K08x8Rz8gS1b9mFtcPj6yux058WAW--HIoIQRFGeppiO3S6s1hzkU2jiKMGtTnB8X4MIJXLPq8LHcZO81appEzraHFUG5ewtKRTq5Ck6OFndlSmhT8KIKid806wI5b39eeoe-4c8Os23QuyWIQthG-YdcTSueNoqZ3-5e7HztoYbzNIKvtrdLpwgMAclD9fzs3oCclECAQaaLD3hWENE3n78_TzPt4OvQ4o8L17JTmozZYCq3VDnsp_M9Bb6az8mZfDX5_ALunsE65dv91aXFCjTJigVJ_r28k7kLVct-PVZ1XPSjdAyGoxttMeYpl24737aUZBqPAirHJK-griQlPBh04E0Ay5ip03gJvJxvGuzRE5r8hKD0lVQjfre9huiSjJX-xts4kbY",
      "token_type":"Bearer",
      "expires_in":300
    }

5분access_token후에 만료되지만 필요할 때마다 코드를 다시 실행하여 새 코드를 받을 수 있습니다. 다음 단계에서 API 요청이UNAUTHORIZED오류를 반환하면 새 요청이 필요하다는 것을 알 수 있습니다.

비디오 만들기

를 호출하면 Video Cloud에 비디오 객체가CMS API생성됩니다. 요청 본문은name및 와 같은 메타데이터를 규정합니다description . 유일한 필수 필드는 입니다name .

다음 코드를 텍스트 편집기에 복사하고 자신의 Video Cloud 계정 ID와 이전 단계의 요청에 대한 응답의ACCOUNT_IDACCESS_TOKEN토큰으로 교체하십시오.

    curl --request POST \
    --url https://cms.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/ \
    --header 'authorization: Bearer ACCESS_TOKEN' \
    --header 'content-type: application/json' \
    --data '{"name": "My Video"}'

JSON 응답에는 동영상에 대한 다양한 메타 데이터가 포함되지만 우리의 목적을 위해 중요한 필드가 맨 위에 있습니다.
```
    {
      "id": "123456789001",
      …
    }
```
아래 인제스트id요청에서 이를 사용하여 비디오 소스 파일을 연결할 비디오를 Video Cloud에 알려줄 수 있습니다.

수집 요청

Dynamic Ingest를 호출하면 수집 할 파일의 위치를 알 수 있습니다.

다음 코드를 텍스트 편집기에 복사하고 바꿉니다. ACCOUNT_ID자신의 Video Cloud 계정 ID로, VIDEO_ID와 더불어id동영상을 만들 때 반환된 값 및ACCESS_TOKEN이전 단계에서 요청에 대한 응답의 토큰으로.
```
    curl --request POST \
      --url https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/VIDEO_ID/ingest-requests \
      --header 'authorization: Bearer ACCESS_TOKEN' \
      --header 'content-type: application/json' \
      --data '{
        "master": {
          "url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
        },
        "callbacks": ["https://solutions.brightcove.com/bcls/di-api/di-callback-app.php"]
      }'
```
여기에있는 비디오 및 콜백 앱은 테스트 목적으로 Brightcove Learning Services에서 제공합니다. 이를 자신의 비디오 및 / 또는 콜백 앱에 대한 경로로 바꿀 수 있습니다. 인제스트 작업과 관련된 알림을 받지 않아도 되는 경우callbacks필드를 생략할 수 있습니다.

콜백 앱을 사용하는 경우 알림을볼 수 있습니다 . 이 앱은 다른 여러 앱의 콜백에 사용되므로 작업 ID를 사용하여 작업과 관련된 항목을 검색하십시오.

다음과 같은 응답을 받아야합니다.

    {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}

이 작업과 관련된 알림을 식별하는 데 유용하거나 지원팀에 문의해야하는 경우 작업 ID를 저장해야합니다.

위의 단계를 성공적으로 완료 한 경우 Dynamic Ingest API를 사용하여 계정에 동영상을 수집했습니다. 문제나 질문이 있는 경우 언제든지브라이트코브 학습서비스에 문의하여 도움을 받으십시오.

API를 광범위하게 사용하고 있다면 CURL 외에 다른 테스트 도구를 사용해 보는 것도 좋습니다.