Google の API 変更への対応:Uppy プラグインの更新と解決策
2024年初頭、Google は連携の継続を希望するパートナーに対して、より厳格なセキュリティ評価を導入し、外部連携の制限を強化し始めました。この変更は、ホスト型の Companion サービスを通じて Google Drive と Google Photos 向けの
Uppy プラグインを提供する Transloadit に大きな影響を与え、お客様にも影響が及んでいます。毎年更新が必要な Google の審査要件に対応してきましたが、小規模な企業として、長期的な準拠の維持は財務面で持続できないと判断しました。その結果、Google によって当社のアプリがブロックされ、Transloadit の Google OAuth2 アプリ ID に依存するお客様とそのエンドユーザーに、Google hasn't verified this app や
This app is blocked などのエラーが発生しています。この状況は、外部プロバイダーとの連携を無期限には保証できない理由を示しています。また、お客様自身の認証情報を使うことを推奨する理由も改めて明確になりました。Transloadit のアプリ認証情報は、主に概念実証と、Uppy の利用開始時の手間の軽減を目的としていたためです。
Google Photos の変更
さらに、2024年9月に Google は発表しました。Google Photos API を変更し、アプリがアクセスできるファイルを、そのアプリ自身がアップロードしたものだけに制限するという内容です。この変更は 2025年3月から適用されます。Uppy には Google Photos アカウントへファイルをアップロードする機能がないため、最近開発した Google Photos プラグイン(@uppy/google-photos)は事実上利用できなくなり、近いうちに削除する予定です。
解決策
選択肢 1:独自の Google Drive OAuth2 認証情報を使用
現在 Google Drive プラグインを使用している場合、既存のプラグイン(@uppy/google-drive)を引き続き利用する方法があります。ただし、Google の審査手続きをご自身で完了する必要があります。その後、独自の OAuth2 認証情報を使って、Uppy を Transloadit の Companion サーバーと組み合わせて利用できます。Google によると、この審査には最大 8週間かかる場合があり、毎年の更新も必要です。Transloadit のホスト型 Companion サーバーで独自の認証情報を設定する手順は、カスタム認証情報の利用ガイドを参照してください。
選択肢 2:Google Picker プラグインへの移行
多くの企業にとって、こうした制限の厳しいスコープのトークンを取得するための広範な要件を満たすのは困難です。そこで、すぐに新しいプラグインを二つ開発し始めました。@uppy/google-drive-picker と @uppy/google-photos-picker です。
これらのプラグインは 2024年12月にリリースしました。Google Picker UI を利用することで、審査手続きを大幅に簡素化します。Picker API を使う場合、Google Drive は審査が一切不要で、Google Photos も最小限の審査で済みます。
一方で、制御できる範囲が狭まる、フォルダーを選択できない、追加のバンドルのダウンロードが必要、ユーザー体験の一貫性が下がる、といったトレードオフがあります。それでも、多くの組織にとっては、煩雑な審査手続きを避けられる利点がこれらの制約を上回ります。
Companion サーバーを自分で運用したくない場合は、これらの新しい Google Picker プラグインでも
Transloadit の Companion サーバーを利用できます。実装の詳細は、@uppy/google-drive-picker と
@uppy/google-photos-pickerのドキュメントを参照してください。
Picker プラグインの問題や現在の状況については、Picker プラグインの状況を追跡する Issueを参照してください。
併せて紹介:Instagram
同じ時期に、Facebook も Instagram API の非推奨化を決定しました。この API は、Uppy と Companion でユーザーが Instagram アカウントから写真を選択できるようにするために使用しています。2024年12月4日以降、別の API を使うビジネスアカウントを除き、Instagram でユーザーの写真を取得する API は利用できなくなります。対応には Uppy にまったく新しい連携を実装する必要がありますが、現時点では優先していません。
関連情報
Google の API 変更への対応に苦慮している他社からも、同様の事例が報告されています。
