【Python】GoogleDriveAPIをつかってGoogleDriveにアクセスする方法

Python から GoogleDriveAPI を使って GoogleDrive にアクセスする方法をご紹介します。

手順は以下のとおりです。

GoogleCloud プロジェクトの作成
GoogleDriveAPI の有効化
サービスアカウントの作成
鍵の取得
GoogleDriveフォルダの共有設定
GoogleDriveフォルダID を調べる
Pythonプログラムの実行

認証方法には、下の３つがあります。

資格情報の種類	説明
APIキー	一般公開データに匿名でアクセスを提供し、認証不要
OAuth クライアント ID	リクエストを送信する際にブラウザを開いてユーザー認証
サービスアカウント	認証情報をJSON形式で保管し、リクエストを送信する際に認証

Python からユーザの手を介さずに 自動的に認証させたいためサービスアカウント を使用します。

ではいってみましょう。

GoogleCloudプロジェクトの新規作成
Google Drive API の有効化
サービスアカウントの作成
鍵の取得
鍵の移動
GoogleDriveフォルダの共有設定
GoogleDrive フォルダID を調べる
Python プログラムの実行
プログラムの解説
実行結果
ファイルをダウンロードする
- 📌 プログラムの解説
おわりに

GoogleCloudプロジェクトの新規作成

１．Google Cloud プラットフォームにアクセスします。

２．Google にログインします。

３．以下の画像の赤枠で囲っている部分をクリックします。

４．新しいプロジェクトをクリックします。

５．任意のプロジェクト名を入力します。

　　プロジェクトIDを変更したい場合は、編集から任意のプロジェクトIDに変更します。

　　最後に作成をクリックします。

６．通知が表示されるので、プロジェクトを選択をクリックします。

Google Drive API の有効化

１．左上のメニュー ⇒ “API とサービス” ⇒ “有効な API とサービス” をクリックします。

２． “API とサービスを有効にする” をクリックします。

３．“google drive api” と入力します。

４．検索結果から Google Drive API を選択し 有効にする をクリックします。

サービスアカウントの作成

１．左上のメニューより API とサービス ⇒ 認証情報をクリックします。

２．サービスアカウントを管理をクリックします。

３．サービスアカウントを作成をクリックします。

４．任意のサービスアカウント名を入力します。

　　サービスアカウントID は自動で設定されます。

　　作成して続行をクリックします。

５．ロールに編集者を選択して続行をクリックします。

📌どのロールを選ぶべき？

・「オーナー」 → 　プロジェクト全体の管理をする場合のみ（強力な権限のため注意！）

・「閲覧者」 　→ 　設定を確認するだけなら適切

・「参照者」 　→　ログや監査情報の閲覧が必要な場合に使う

・「編集者」 　→ 　設定やデータを変更するが、課金管理は不要な場合

６．この項目は空白のまま完了をクリックします。

この項目の補足説明

「サービスアカウントユーザー」ロール → このサービスアカウントを使ってジョブや VM をデプロイできる。（代理実行が可能）
「サービスアカウント管理者」ロール → このサービスアカウントの設定を変更したり、新しいキーを生成できる。（管理権限）

もしロールを設定しない場合 → そのサービスアカウントを代理で使う人がいないため、自分以外はサービスアカウントを利用できません。 → ただし、サービスアカウント自体の認証情報（JSON キー）があれば、Python から Google Drive にアクセスすることはできます。

まとめ

Python から Google Drive にアクセスするだけなら、この項目を空白にしても問題なし。
他のユーザーやシステムとサービスアカウントを共有するなら、ロールを設定して権限を管理する必要あり。

鍵の取得

１．右の ︙ から鍵を管理をクリックします。

２．キーを追加 ⇒ 新しい鍵を作成をクリックします。

３．JSON形式であることを確認し作成をクリックします。

４．閉じるをクリックします。

鍵の移動

１．秘密鍵 *****.json ファイルを Cドライブ直下に移動します。

GoogleDriveフォルダの共有設定

１．GoogleDrive にアクセスします。

２．マイドライブ ⇒ Python からアクセスしたいフォルダの ︙ をクリック

　　⇒ 共有 ⇒ 共有をクリックします。

３．赤枠の欄にサービスアカウントのメールアドレスを入力し完了をクリックします。

４．編集者であることを確認し送信をクリックします。

GoogleDrive フォルダID を調べる

１．先ほど共有設定したフォルダを開き URL の最後の部分をコピーします。

Python プログラムの実行

１．ライブラリのインストール

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

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

２．Pythonプログラム

from google.oauth2 import service_account
from googleapiclient.discovery import build

# 認証情報のセットアップ
SCOPES = ["https://www.googleapis.com/auth/drive"]
# ここに Cドライブ に移動した JSONファイル名 を入れてください
SERVICE_ACCOUNT_FILE = r"c:\******************.json"

creds = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

# Google Drive APIの初期化
drive_service = build("drive", "v3", credentials=creds)

# アクセスするフォルダIDを設定
FOLDER_ID = "ここにコピーしたフォルダIDを入れてください"

# フォルダ内のファイル一覧を取得
query = f"'{FOLDER_ID}' in parents"
results = drive_service.files().list(q=query, fields="files(id, name)").execute()
files = results.get("files", [])

if not files:
    print("Google Driveにファイルが見つかりませんでした。")
else:
    print("Google Driveのファイル一覧:")
    for file in files:
        print(f"{file['name']} ({file['id']})")

from google.oauth2 import service_account

from googleapiclient.discovery import build

# 認証情報のセットアップ

SCOPES = ["https://www.googleapis.com/auth/drive"]

# ここに Cドライブに移動した JSONファイル名を入れてください

SERVICE_ACCOUNT_FILE = r"c:\******************.json"

creds = service_account.Credentials.from_service_account_file(

SERVICE_ACCOUNT_FILE, scopes=SCOPES)

# Google Drive APIの初期化

drive_service = build("drive", "v3", credentials=creds)

# アクセスするフォルダIDを設定

FOLDER_ID = "ここにコピーしたフォルダIDを入れてください"

# フォルダ内のファイル一覧を取得

query = f"'{FOLDER_ID}' in parents"

results = drive_service.files().list(q=query, fields="files(id, name)").execute()

files = results.get("files", [])

if not files:

print("Google Driveにファイルが見つかりませんでした。")

else:

print("Google Driveのファイル一覧:")

for file in files:

print(f"{file['name']} ({file['id']})")

プログラムの解説

🔹 1. 必要なライブラリのインポート

まず、Google の API を利用するために以下のライブラリをインポートしています：

from google.oauth2 import service_account
from googleapiclient.discovery import build

1 2	from google.oauth2 import service_account from googleapiclient.discovery import build

google.oauth2.service_account → サービスアカウントを使った認証を処理する
googleapiclient.discovery → Google の API（Drive API など）に接続する

🔹 2. 認証情報のセットアップ

次に、Google Drive API にアクセスするために、サービスアカウントの認証情報を設定します。

SCOPES = ["https://www.googleapis.com/auth/drive"]
# ここに Cドライブ に移動した JSONファイル名 を入れてください
SERVICE_ACCOUNT_FILE = r"c:\***************************.json"

SCOPES = ["https://www.googleapis.com/auth/drive"]

# ここに Cドライブに移動した JSONファイル名を入れてください

SERVICE_ACCOUNT_FILE = r"c:\***************************.json"

SCOPES → Google Drive にアクセスするための権限（https://www.googleapis.com/auth/drive）
SERVICE_ACCOUNT_FILE → 事前にダウンロードした サービスアカウントの認証キー（JSONファイル） のパス

この JSON ファイルには、API を実行するための秘密鍵 が含まれているので、第三者に共有しないよう注意しましょう。

🔹 3. 認証情報を使用して API に接続

creds = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES
)
drive_service = build("drive", "v3", credentials=creds)

creds = service_account.Credentials.from_service_account_file(

SERVICE_ACCOUNT_FILE, scopes=SCOPES

)

drive_service = build("drive", "v3", credentials=creds)

Credentials.from_service_account_file() → JSONファイルを使って、Google Drive API の認証をセットアップ
build("drive", "v3", credentials=creds) → Drive API（バージョン3）を使用するためのオブジェクトを作成

これで、Google Drive API への接続が完了しました。

🔹 4. フォルダ内のファイル一覧を取得

FOLDER_ID = "ここにコピーしたフォルダIDを入れてください"
query = f"'{FOLDER_ID}' in parents"
results = drive_service.files().list(q=query, fields="files(id, name)").execute()
files = results.get("files", [])

FOLDER_ID = "ここにコピーしたフォルダIDを入れてください"

query = f"'{FOLDER_ID}' in parents"

results = drive_service.files().list(q=query, fields="files(id, name)").execute()

files = results.get("files", [])

FOLDER_ID → アクセスしたいフォルダの ID（Google Drive の URL から取得可能）
クエリ (query) → "FOLDER_ID in parents" という条件で、指定フォルダ内のファイルを取得
files().list() → クエリに該当するファイル一覧を取得し、id と name を取得

🔹 5. ファイルがあるかチェック & 表示

最後に、取得したファイル一覧を表示します：

if not files:
    print("Google Driveにファイルが見つかりませんでした。")
else:
    print("Google Driveのファイル一覧:")
    for file in files:
        print(f"{file['name']} ({file['id']})")

if not files:

print("Google Driveにファイルが見つかりませんでした。")

else:

print("Google Driveのファイル一覧:")

for file in files:

print(f"{file['name']} ({file['id']})")

ファイルが無ければ「見つかりません」と表示
ファイルがあれば、名前と ID を出力

このコードを実行すると、Google Drive のフォルダ内にあるファイルの一覧がコンソールに表示されます！

実行結果

実行すると Python のターミナルにGoogleDrive のファイル一覧が表示されました！

ファイルをダウンロードする

１．ライブラリのインストール

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

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

２．Pythonプログラム

from google.oauth2 import service_account
from googleapiclient.discovery import build
import io
from googleapiclient.http import MediaIoBaseDownload

# 認証情報のセットアップ
SCOPES = ["https://www.googleapis.com/auth/drive"]
SERVICE_ACCOUNT_FILE = r"c:\*****************.json"  # ダウンロードしたJSONファイルのパス

creds = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

# Google Drive APIの初期化
drive_service = build("drive", "v3", credentials=creds)

# ダウンロードするファイルの ID（Google Drive の URL から取得）
FILE_ID = "ファイルID"
FILE_NAME = "downloaded_file.ext"  # 保存するファイル名

# ファイルのダウンロード処理
request = drive_service.files().get_media(fileId=FILE_ID)
file = io.BytesIO()
downloader = MediaIoBaseDownload(file, request)
done = False
while not done:
    _, done = downloader.next_chunk()

# ダウンロードしたデータをローカルファイルとして保存
with open(FILE_NAME, "wb") as f:
    f.write(file.getvalue())

print(f"{FILE_NAME} をダウンロードしました！")

from google.oauth2 import service_account

from googleapiclient.discovery import build

import io

from googleapiclient.http import MediaIoBaseDownload

# 認証情報のセットアップ

SCOPES = ["https://www.googleapis.com/auth/drive"]

SERVICE_ACCOUNT_FILE = r"c:\*****************.json" # ダウンロードしたJSONファイルのパス

creds = service_account.Credentials.from_service_account_file(

SERVICE_ACCOUNT_FILE, scopes=SCOPES)

# Google Drive APIの初期化

drive_service = build("drive", "v3", credentials=creds)

# ダウンロードするファイルの ID（Google Drive の URL から取得）

FILE_ID = "ファイルID"

FILE_NAME = "downloaded_file.ext" # 保存するファイル名

# ファイルのダウンロード処理

request = drive_service.files().get_media(fileId=FILE_ID)

file = io.BytesIO()

downloader = MediaIoBaseDownload(file, request)

done = False

while not done:

_, done = downloader.next_chunk()

# ダウンロードしたデータをローカルファイルとして保存

with open(FILE_NAME, "wb") as f:

f.write(file.getvalue())

print(f"{FILE_NAME} をダウンロードしました！")

📌 プログラムの解説

💡 このコードの流れ 1️⃣ FILE_ID を指定して Google Drive API にダウンロードリクエスト 2️⃣ ファイルのデータを取得し、MediaIoBaseDownload で分割ダウンロード 3️⃣ ダウンロードデータを BytesIO に格納し、ローカルファイルとして保存