PythonからGooglePhotoに画像や動画をアップロードする手順です。

事前準備

Photo Library APIの有効化

はじめにGoogle PhotoのAPIを利用するために「Photo Library API」を有効化する。まず下記のURLからGCPのコンソールにアクセスする。

検索窓で「Google Photo」と入力し、画像赤枠の「Photo Library API」を選択する。

Photo Library APIの設定画面に遷移するので、「有効にする」を押下する。

実行後、下記のような画面に変わればAPIの有効化は完了。GooglePhotoに対してAPI経由で処理を実行できるようになっている。

認証情報の作成

次にAPIの実行するために必要な、認証情報を作成する。認証情報の作成手順は下記の記事の手順と同じなので、こちらを参照。

作成した認証情報はclient_secrets.jsonの名称で保存しておく。

開発

必要ライブラリのインストール

今回はPhotoAPIを利用するためのgoogle-api-python-clientと認証に利用するgoogle-auth-oauthlibをインストールする。

下記のコマンドを実行し、ライブラリのインストールを行う。

pip install google-api-python-client google-auth-oauthlib

実装

main.py

import pickle
from pathlib import Path

import requests
from google.auth.transport.requests import Request
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# 各URLやスコープ
API_SERVICE_NAME = "photoslibrary"
API_VERSION = "v1"
SCOPES = ["https://www.googleapis.com/auth/photoslibrary.appendonly"]


class GooglePhotoFacade:
    # ログインしてセッションオブジェクトを返す
    def __init__(
        self,
        credential_path: str,
        token_path: str = "",
    ):
        with build(
            API_SERVICE_NAME,
            API_VERSION,
            credentials=self._login(credential_path, token_path),
            static_discovery=False,
        ) as service:
            self.service = service
            print("Google OAuth is Complete.")

        self.credential_path = credential_path
        self.token_path = token_path

    def _login(self, credential_path: str, token_path: str) -> any:
        """Googleの認証を行う

        Args:
            credential_path (str): GCPから取得したclient_secret.jsonのパス
            token_path (str): Oauth2認証によって得られたトークンを保存するパス。

        Returns:
            googleapiclient.discovery.Resource: _description_
        """

        if Path(token_path).exists():
            # TOKENファイルを読み込み
            with open(token_path, "rb") as token:
                credential = pickle.load(token)
            if credential.valid:
                print("トークンが有効です.")
                return credential
            if credential and credential.expired and credential.refresh_token:
                print("トークンの期限切れのため、リフレッシュします.")
                # TOKENをリフレッシュ
                credential.refresh(Request())
        else:
            print("トークンが存在しないため、作成します.")
            credential = InstalledAppFlow.from_client_secrets_file(
                credential_path, SCOPES
            ).run_local_server()

        # CredentialをTOKENファイルとして保存
        with open(token_path, "wb") as token:
            pickle.dump(credential, token)

        return credential

    def upload(
        self, local_file_path: str,
    ):

        self._login(self.credential_path, self.token_path)  # トークンの期限を確認
        
        save_file_name:str = Path(local_file_path).name
        with open(str(local_file_path), "rb") as image_data:
            url = "https://photoslibrary.googleapis.com/v1/uploads"
            headers = {
                "Authorization": "Bearer " + self.service._http.credentials.token,
                "Content-Type": "application/octet-stream",
                "X-Goog-Upload-File-Name": save_file_name.encode(),
                "X-Goog-Upload-Protocol": "raw",
            }
            response = requests.post(url, data=image_data.raw, headers=headers)

        upload_token = response.content.decode("utf-8")
        print("Google Photoへのアップロードが完了しました。")
        body = {"newMediaItems": [{"simpleMediaItem": {"uploadToken": upload_token}}]}

        upload_response = self.service.mediaItems().batchCreate(body=body).execute()
        print("Google Photoへのアップロードした動画の登録に成功しました。")

        # uploadしたURLを返す
        return upload_response["newMediaItemResults"][0]["mediaItem"]


if __name__ == "__main__":
    g = GooglePhotoFacade(
        credential_path="client_secret.json", token_path="token.pkl"
    )
    g.upload(
        local_file_path="qiitan.png", # ここに保存する画像を指定する。
    )

動作確認

動作確認として、下記のQiitanの画像をアップロードしてみる。

$ python main.py
トークンが存在しないため、作成します.
Please visit this URL to authorize this application: ${省略}
Google OAuth is Complete.
Google Photoへのアップロードが完了しました。
Google Photoへのアップロードした動画の登録に成功しました。

初回実行時はOAuth2の認証画面が表示される。はじめに、アップロードしたいGooglePhotoのアカウントを選択する。

下記の画面に遷移されるので「続行」を押下する。

その後下記の画面へ遷移するので、再度「続行」を押下する。

その後、トークンがtoken.pklの名称でローカル保存される。２回目以降はローカルに保存したトークンを利用するので認証画面なしで実行ができる。

実行後、Google Photoにアクセスし、Qiitanの画像がアップロードされていることを確認する。

同じソースコードで動画もアップロードが可能である。local_file_pathにmp4形式の動画を指定する。

main.py

~~~省略~~~

if __name__ == "__main__":
    g = GooglePhotoFacade(
        credential_path="client_secret.json", token_path="token.pkl"
    )
    g.upload(
        local_file_path="sample.mp4", # 動画を指定する
    )

再度下記のコマンドでアップロード処理を実行する。

python main.py

動画がアップロードされたことが確認できる。

参考資料

アップロードしたサンプル動画