動画を Video Intelligence API に渡すには、Cloud Storage URI を渡すか、リクエストの content
フィールドに Base64 エンコードした動画データを直接埋め込みます。
コマンドラインの使用
gRPC リクエスト内に単純にバイナリデータを書き込むことができますが、REST リクエストを行う際には、JSON が使われます。JSON はバイナリデータを直接サポートしていないテキスト形式であるため、それらのバイナリデータは Base64 エンコードを使用して、テキストに変換する必要があります。
ほとんどの開発環境には、バイナリを ASCII テキストデータにエンコードするネイティブの base64
ユーティリティがあります。ファイルをエンコードするには:
Linux
base64
コマンドライン ツールを使用してファイルをエンコードし、-w 0
フラグを使用して、行の折り返しを防ぎます。
base64 INPUT_FILE -w 0 > OUTPUT_FILE
macOS
base64
コマンドライン ツールを使用してファイルをエンコードします。
base64 -i INPUT_FILE -o OUTPUT_FILE
Windows
Base64.exe
ツールを使用してファイルをエンコードします。
certutil -encodehex SOURCE_VIDEO_FILE > DEST_TEXT_FILE 0x40000001
PowerShell
Convert.ToBase64String
メソッドを使用してファイルをエンコードします。
[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE
base64 エンコードされたデータをインラインで挿入して、JSON リクエスト ファイルを作成します。
JSON
{ "requests":[ { "image":{ "content": "ZkxhQwAAACIQABAAAAUJABtAA+gA8AB+W8FZndQvQAyjv..." }, "features": [ { "type":"LABEL_DETECTION", "maxResults":1 } ] } ] }
クライアント ライブラリの使用
テキスト エディタを使ってリクエストにバイナリデータを埋め込むことは実用性に欠け、また望ましくありません。実際には、クライアント コード内に base64 エンコード ファイルを埋め込みます。サポートされるすべてのプログラミング言語には、base64 エンコード コンテンツの組み込みメカニズムがあります。
Python
Python では、次のように動画ファイルを Base64 エンコードします。
# Import the base64 encoding library.
import base64
# Pass the video data to an encoding function.
def encode_video(video):
video_content = video.read()
return base64.b64encode(video_content)
Node.js
Node.js では、次のように動画ファイルを Base64 でエンコードします。
// Read the file into memory.
var fs = require('fs');
var videoFile = fs.readFileSync('/path/to/file');
// Convert the video data to a Buffer and base64 encode it.
var encoded = new Buffer(videoFile).toString('base64');
Java
Java で画像ファイルを base64 エンコードする方法は次のとおりです。
// Import the Base64 encoding library.
import org.apache.commons.codec.binary.Base64;
// Encode the video.
byte[] videoData = Base64.encodeBase64(videoFile.getBytes());