지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    빠른 시작: Dynamic Ingest API

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

    서문

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

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

    단계

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

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

    1. API 자격 증명 관리 Studio의 섹션.

    2. 딸깍 하는 소리새 신청서 등록
    3. 적절한 계정을 선택하고적어도이러한 권한 :

      • 동적 수집 생성
      • 수집 프로필 구성 읽기
      • 수집 프로필 읽기
    4. 복사 및 저장클라이언트 ID클라이언트 비밀 (대화 상자를 닫으면 클라이언트 암호를 다시 가져올 수있는 방법이 없습니다!).

    OAuth 토큰 받기

    그만큼client_idclient_secret다음 요청을 인증하는 데 사용되는 토큰 (기본 인증)을 얻기 위해 사용자 이름 및 비밀번호로 사용됩니다.

    1. 아래 코드를 텍스트 편집기에 복사하고CLIENT_IDCLIENT_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
    2. 수정 된 코드를 복사하여 터미널 (또는 명령 줄 앱)에 붙여넣고 Return 키를 눌러 실행합니다.
    3. 응답은 다음과 같아야합니다.
          {
            "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
          }
    4. 참고access_token 5 분 내에 만료되지만 필요할 때마다 코드를 다시 실행하여 새 코드를 얻을 수 있습니다. 다음 단계의 API 요청이UNAUTHORIZED오류.

    비디오 만들기

    에 대한 전화CMS API Video Cloud에서 비디오 개체를 만듭니다. 요청 본문은 다음과 같은 메타 데이터를 규정합니다. namedescription . 유일한 필수 필드는name .

    1. 다음 코드를 텍스트 편집기에 복사하고ACCOUNT_ID자신의 Video Cloud 계정 ID로ACCESS_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"}'
    2. JSON 응답에는 동영상에 대한 다양한 메타 데이터가 포함되지만 우리의 목적을 위해 중요한 필드가 맨 위에 있습니다.
          {
            "id": "123456789001",
            …
          }

      당신은 이것을 사용할 것입니다id아래의 Ingest 요청에서 Video Cloud에 비디오 소스 파일을 연결할 비디오를 알립니다.

    수집 요청

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

    1. 다음 코드를 텍스트 편집기에 복사하고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://learning-services-media.brightcove.com/videos/mp4/Great_Blue_Heron.mp4"
              },
              "callbacks": ["https://solutions.brightcove.com/bcls/di-api/di-callback-app.php"]
            }'

      여기에있는 비디오 및 콜백 앱은 테스트 목적으로 Brightcove Learning Services에서 제공합니다. 이를 자신의 비디오 및 / 또는 콜백 앱에 대한 경로로 바꿀 수 있습니다. 수집 작업에 대한 알림을받을 필요가없는 경우callbacks들.

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

    2. 다음과 같은 응답을 받아야합니다.
          {"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
    3. 이 작업과 관련된 알림을 식별하는 데 유용하거나 지원팀에 문의해야하는 경우 작업 ID를 저장해야합니다.

    위의 단계를 성공적으로 완료 한 경우 Dynamic Ingest API를 사용하여 계정에 동영상을 수집했습니다. 문제 나 질문이 있으시면 언제든지 연락하십시오. Brightcove 학습 서비스도와주기 위해.

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