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

    빠른 시작: Dynamic Ingest API

    이 빠른 시작은 동영상을 Video Cloud 를 사용하여 Dynamic Ingest API CURL을 통해.

    소개

    당신은 여러 가지 일을 할 수 있습니다. Dynamic Ingest API, 그것의 주요 기능은 비디오를 Video Cloud. 이 퀵 스타트에서는 API를 사용하여 첫 번째 동영상을 섭취하도록 안내하는 간단한 자습서를 제공합니다.

    이 자습서에서는 CURL이라는 널리 사용되는 명령 행 도구를 사용하여 HTTP 요청을 작성합니다. CURL에 익숙하지 않은 경우 CURL 설정. CURL은 기본적으로 Mac 및 Linux 시스템에 설치됩니다. Windows에서는 설치가 필요합니다 - 지시 사항은 CURL 설정 안내서에 나와 있습니다.

    단계

    클라이언트 자격 증명 얻기

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

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

    2. Click 하십시요. 새로운 신청서 등록
    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 요청에서 다음을 반환하면 새 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 응답에는 동영상에 대한 다양한 메타 데이터가 포함되지만 Google의 목적을 위해 중요한 필드가 맨 위에 표시됩니다.
          {
            "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 학습 서비스 도움.

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


    12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지