Google Developers Japan

Ads API での同意の分割について

2025年3月26日水曜日

この記事は Anash P. Oommen による Google Ads Developer Blog の記事 "Consent unbundling in Ads APIs" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

変更事項

2025 年 5 月 1 日の週より、2019 年以前に作成されたすべての Google Cloud プロジェクトで、OAuth ユーザー認証の同意の分割がロールアウトされます。2019 年以前に作成された Google Cloud プロジェクトで広告関連の API を利用するアプリケーションでは、分割されたユーザーの同意に対応するため、Read More

変更事項

背景

OAuth ユーザー認証フローで同意を分割すると、すべてかゼロかのアプローチではなく、アプリケーションで認可したい特定の OAuth スコープをユーザーがカスタマイズできます。この機能は、2019 年以降に作成されたすべての Google Cloud コンソールプロジェクトでオンになっていますが、2019 年以前に作成されたすべてのプロジェクトではオフになっています。

次のスクリーンショットは、すべてかゼロかの同意プロンプトと、分割された同意プロンプトの違いを示しています。

図 1: すべてかゼロかの同意画面。ユーザーは OAuth スコープのリストから選択することはできない。

図 2: 分割された同意画面。ユーザーは OAuth スコープのリストから選択できる。

変更の影響を受けるのは誰ですか？

次の条件をすべて満たす場合、この変更の影響を受けます。

API アプリケーションで、2019 年以前に作成された Google Cloud コンソールプロジェクトを使っている。
アプリケーションで OAuth 2.0 ユーザー同意フローを実装している。これは、ユーザーが Google アカウントでログインし、アプリケーションが要求する 1 つ以上の権限を付与する認証ワークフローです。
アプリケーションで複数の Google API を使っており、後述する広告関連の API が含まれている。

変更の影響を受けないのは誰ですか？

既存の更新トークン: この変更は、以前に行われたユーザー認証には影響しません。既存の更新トークンは引き続き動作し、変更や再認証の必要はありません。
単一スコープアプリケーション: アプリケーションで 1 つの Google API スコープしか使っていない場合、分割できる OAuth スコープがないため、この変更の影響を受けません。
シングルユーザーアプリケーション / 手動で認証したアプリケーション: このようなアプリケーションには、明示的な OAuth ユーザー認証フローが実装されていません。代わりに GenerateUserCredentials、gcloud CLI、OAuth Playground などの手動認証スクリプトでユーザーを認証し、その資格情報を長期間にわたって利用します。認証の際に、アプリケーションが必要とするすべてのスコープが選択されるため、アプリケーションはこの変更の影響を受けません。
サービスアカウント: アプリケーションがサービスアカウントを使って API 呼び出しを認証している場合、この変更による影響はありません。

何をする必要がありますか？

アプリケーションが部分的なユーザーの同意に対応できるようにする必要があります。これを行うには、

OAuth フローに include_granted_scopes パラメータを含め、ユーザーが同意した OAuth スコープのリストをリクエストします。
ユーザーが実際に OAuth 応答で同意した OAuth スコープのリストを調べます。
アプリケーションで段階的な認可を実装します。

きめ細かい同意に対応するための要件とベストプラクティスについては、OAuth のきめ細かい同意に対応するためのガイドをご覧ください。

どうすればこの機能をテストできますか？
この機能をテストする方法には、次の 2 種類があります。

新しい Google Cloud プロジェクトを作成する: 新しい Google Cloud プロジェクトでは、OAuth の同意の分割が有効になっています。そのため、新しい Google Cloud プロジェクトを作成して、アプリケーションのテストに使うことができます。
既存のプロジェクトで同意の分割を有効にする: OAuth の認可リクエストで enable_granular_consent パラメータを true に設定します。

どの API スコープが影響を受けますか？
この変更の影響を受けるのは、次の広告関連 API です。

API	OAuth スコープ
Google Ads API	https://adwords.google.com/api/adwords
Google Ad Manager API（SOAP API、ベータ版）	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display and Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
Real time bidding API	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

サポートの利用方法

ご不明な点がある場合や、サポートが必要な場合は、それぞれの API のサポートチームにお問い合わせください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team

Google Ads API v19 のお知らせ

2025年3月21日金曜日

この記事は Thanet Knack Praneenararat による Google Ads Developer Blog の記事 "Announcing v19 of the Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。 ...Read More

この記事は Thanet Knack Praneenararat による Google Ads Developer Blog の記事 "Announcing v19 of the Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

Google Ads API の v19 リリースをお知らせします。v19 の一部の機能を使用するには、クライアントライブラリとクライアントのコードをアップグレードする必要があります。更新版のクライアントライブラリとコードサンプルは、公開されました。

主な機能は以下のとおりです。

P-MAX キャンペーン用の拡張動画アセットの自動生成がサポートされます。
Feed、FeedMapping、FeedService、AdGroupFeed、feed_placeholder_view など、フィード関連のすべてのエンティティが Google Ads API から削除されます。アセットを使ってください。
デマンドジェネレーション広告で 9:16 の縦向き画像アセットがサポートされます。DemandGenMultiAssetAdInfo.tall_portrait_marketing_images を使うと、このアセットを広告に追加できます。
DataLinkService にメソッドを追加し、以前に作成した YouTube 用 DataLink を更新および削除できるようにしました。
ValueRuleItineraryAdvanceBookingWindow で、当日の旅行検索のターゲティングがサポートされます。
VIDEO_OUTSTREAM に対するサポートを削除しました。
（許可リストに登録されたアカウントのみ）ブランドガイドラインの更新
- P-MAX キャンペーンの作成中に、ブランドガイドラインを有効化できるようになります。また、新しい CampaignService.EnablePMaxBrandGuidelines も追加し、既存の P-MAX キャンペーンのブランドガイドラインを有効化できるようにしています。
- Campaign.brand_guidelines を使うと、フォントファミリーや色など、細かいブランドガイドラインを設定できます。
（許可リストに登録されたアカウントのみ）Asset.business_message_asset によるメッセージアセットがサポートされます。

さらに詳しく知りたい方へ
以下のリソースが役立ちます。

ご質問やさらにサポートが必要なことがありましたら、フォーラムからご連絡ください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team

Google Ads API の CustomerService の変更予定について

2025年3月21日金曜日

この記事は Anash P. Oommen による Google Ads DeveloperBlog の記事 "Upcoming changes to CustomerService in Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。 ...Read More

この記事は Anash P. Oommen による Google Ads DeveloperBlog の記事 "Upcoming changes to CustomerService in Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

CustomerService.CreateCustomerClient メソッドにいくつかの変更を導入します。これは、Google Ads API と Google 広告 UI の新規アカウント作成機能を一致させるための措置です。この変更は、2025 年 3 月 17 日に適用されました。

ポリシー適用のための新しいエラーコード
ポリシーを適用して不正利用を制限するため、Google Ads API バージョン v19 で 2 つの新しいエラーコードを導入しています。

Google 広告クライアントセンターアカウントにポリシー上の問題がない（ポリシー違反のため、一時停止されたり、閉鎖されたりしていないことなど）場合でも、一定の支出基準額または一定数のアクティブな子アカウントがなければ、子アカウントを作成することはできません。Google Ads API の v19 では、CustomerError.CREATION_DENIED_INELIGIBLE_MCC エラーコードが返されます。この問題を解決するには、Google のポリシーに準拠し、クライアントセンターアカウントの支出基準額を満たす Google 広告アカウントをリンクしてください。
アカウント作成に関連するポリシー違反状態の Google 広告クライアントセンターアカウントは、子アカウントを作成できなくなります。Google Ads API の v19 では、CustomerError.CREATION_DENIED_FOR_POLICY_VIOLATION エラーコードが返されます。

v18 以前の API バージョンでは、どちらの場合も ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT エラーがスローされます。

アカウント作成の割り当て制限
Google Ads API による新規 Google 広告アカウントの作成に制限がかかります。上限に達すると QuotaError.RESOURCE_EXHAUSTED エラーが返されます。quota_error_details の retry_delay フィールドには追加情報が含まれており、API 呼び出しの再試行までに必要な待機時間を確認できます。ほとんどのデベロッパーは、この制限の影響を受けることはないでしょう。

何をする必要がありますか？
アプリケーションで Google Ads API を使って新規 Google 広告アカウントを作成している場合は、コードを確認し、新しいエラーコードを正しく処理できることを確認してください。

不明な点がある方やサポートが必要な方は、Google Ads API のサポートページでオプションをご確認ください。アカウントのポリシーに関する質問は、Google 広告プロダクトサポートチームまでお問い合わせください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team

2025 年 4 月 7 日よりカスタマーマッチのメンバーシップ有効期限を更新

2025年3月19日水曜日

この記事は Da Yang, Trevor Mulchay による Google Ads Developer Blog の記事 "Update to Customer Match membership expiration starting April 7, 2025" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

2025 年 4 月 7 日より、Google 広告とディスプレイ＆ビデオ 360 プラットフォームのカスタマーマッチリストに最大 540 日間のメンバーシップ期間が新たに導入され、徐々にロールアウトされます。これは、カスタマーマッチのベストプラクティスへの準拠性を高めるための変更です。

この日以降、メンバーシップの有効期限が設定されていない既存リスト、あるいは 540 日を超えるメンバーシップ有効期限が設定されている既存リストは、最大メンバーシップ期間が 540 日に更新されます。期間が 540 日を超える既存メンバーには、540 日のメンバーシップ期間が遡及的に適用されます。メンバーシップの有効期限が切れるに連れて、反映されるリストのサイズは小さくなります。キャンペーンのターゲットとなるユーザーのセグメントが小さすぎると、広告を配信できず、自動的に一時停止される可能性があります。2025 年 4 月 7 日までにカスタマーマッチリストを更新し、メンバーシップを更新するか、期限切れのカスタマーマッチリストを最新のリストに置き換えてください。それにより、広告キャンペーンの中断を回避できます。

メンバーシップ期間を設定している場合は、定期的にカスタマーデータをリストに再アップロードし、リストを更新する必要があります。これを行わないと、時間の経過とともにリストのサイズが小さくなります。カスタマーマッチの詳細については、こちらの記事をご覧ください。

Google Ads API ユーザーに必要なアクション

2025 年 4 月 7 日以降、Google Ads API の UserList.membership_life_span フィールドに 540 を超える値を設定するリクエストを行うと、RangeError.TOO_HIGH エラーが返されます。現在の実装を確認し、フィールド値が 540 を超えないようにしてください。

Google Ads API の既存ユーザーリストの membership_life_span フィールドが 540 を超えている場合、2025 年 4 月 7 日より、カスタマーデータのユーザーリストのメンバーシップ期間が最大 540 日に自動移行されます。カスタマーリストを定期更新するにあたり、コードの更新が必要になる場合は、ガイドに記載されている例をご覧ください。

Google Ads API で membership_life_span フィールドを設定しておらず、カスタマーリストを定期的に更新している場合、アクションは必要ありません。フィールドに何も設定しないと、最大値の 540 日に設定したときと同じ動作になります。

問題が発生した場合や、変更について不明な点がある場合は、Google Ads API フォーラムからお問い合わせください。

Display & Video 360 API ユーザーに必要なアクション

2025 年 4 月 7 日以降、Display & Video 360 API の membershipDurationDays フィールドに 540 を超える値を設定する firstAndThirdPartyAudiences.create リクエストと firstAndThirdPartyAudiences.patch リクエストを行うと、400 エラーが返されます。カスタマーマッチリストを作成するときは、membershipDurationDays フィールドを設定する必要があるため、現在の実装を確認し、このフィールドに 540 を超える値を設定しないようにしてください。

既存のカスタマーマッチリストの membershipDurationDays フィールドが 540 日を超える値に設定されている場合、2025 年 4 月 7 日より、最大 540 日の新しいメンバーシップ期間に自動移行されます。この日付以降、カスタマーマッチリストを定期的に更新する必要があります。カスタマーマッチリストを更新する方法の例は、ガイドをご覧ください。

問題が発生した場合や、変更について不明な点がある場合は、Display & Video 360 API テクニカルサポート問い合わせフォームからお問い合わせください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team

【〆切間近 3/6 】セッション登壇でスポットライトを浴びよう！

2025年3月5日水曜日

あなたの知識と経験が、未来を拓く！

2025 年 8 月 5 日（火）、 6 日（水）に開催する旗艦イベント Google Cloud Next Tokyo でブレイクアウトセッションを募集しています。

応募締め切り 3 月 6 日（木）まで残りわずかとなりました。ご検討中の方はぜひ、お早めに公式サイトからご応募ください！

Google Cloud 製品を活用したイノベーションや、アプリケーション開発、データ・AI の利活用、従業員同士のコラボレーションなど、企業の様々な課題を解決するナレッジをご紹介いただき、Next Tokyo を一緒に盛り上げていただける方をお待ちしています！

Next Tokyo ブレイクアウトセッションで求めている要素の一例

あなたの知識と経験が、未来を拓く！

2025 年 8 月 5 日（火）、 6 日（水）に開催する旗艦イベント Google Cloud Next Tokyo でブレイクアウトセッションを募集しています。

応募締め切り 3 月 6 日（木）まで残りわずかとなりました。ご検討中の方はぜひ、お早めに公式サイトからご応募ください！

Next Tokyo ブレイクアウトセッションで求めている要素の一例

☁️ Google Cloud を活用して未来を形作る、熱いアイデアをお持ちの方

☁️ Google Cloud のワクワクするステージでスポットライトを浴びたい方

☁️ ビジネスの未来を担うイベント参加者と共に学び、交流する場を楽しみたい方

あなたの知識が、誰かの未来を変えるかもしれません。

ぜひ、奮ってご応募ください！

公式サイトからブレイクアウトセッションに応募
募集期日： 2025 年 3 月 6 日（木）17 時まで

開催概要

名称 : Google Cloud Next Tokyo（略称 Next Tokyo）

日時 : 2025 年 8 月 5 日（火）、6 日（水）

会場 : 東京ビッグサイト南展示棟

対象 : 開発者から経営者まで、生成 AI やクラウドテクノロジーを使ってビジネス課題の解決を探求するすべての方

- セッション募集に関するお問い合わせ -

Google Cloud Next Tokyo スピーカー事務局：

GoogleCloudNextTokyo-Speakers@google.com

ID チェックと機能拡張で Android の盗難防止を強化

2025年2月25日火曜日

この記事は Jianing Sandra Guo, Nataliya Stanetsky による Google Security Blog の記事 "Android enhances theft protection with Identity Check and expanded features" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。 ...Read More

現在、世界中の人々がモバイルデバイスを使い、指先だけで、友人や家族とのつながりを維持したり、金銭を管理したり、ヘルスケア情報を追跡したりしています。しかし、デバイスが悪意のある人に盗まれると、機密データの流出、ID の盗難、金融詐欺、プライバシー侵害といった被害に遭う可能性があります。

先日、その対策として、Android の盗難防止機能をリリースしました。この包括的な機能は、デバイスの盗難前、盗難中、盗難後のすべての段階で、ユーザーとデータを保護できるように設計されています。Android の安全を確保するための取り組みの一環として、この機能を拡張して強化し、世界中のユーザーがさらに強力な保護を受けられるようにします。

ID チェックを Pixel および Samsung One UI 7 デバイスにロールアウト

最初に ID チェックが正式導入されるのは、Pixel と One UI 7¹ の対象となる Samsung Galaxy デバイスです。これらのデバイスでは、アカウントとデバイスに関する重要な設定の保護が強化されます。ID チェックをオンにすると、信頼できる場所以外から特定の機密リソースにアクセスする場合に、デバイスで明示的な生体認証が必須になります。さらに、サポートされているすべてのデバイスで Google アカウントの保護が強化されます。One UI 7 対応の Galaxy デバイスでは、Samsung アカウントのセキュリティが強化され、デバイスにログインしているアカウントの不正な乗っ取りがはるかに難しくなります。

ID チェックを有効化する際に、複数の信頼できる場所を指定できます。信頼できる場所以外にいる場合、デバイスの PIN や生体認証の変更、盗難防止の無効化、パスキーへのアクセスなど、アカウントやデバイスに関する重要な設定にアクセスする際に、生体認証が必須になります。

ID チェックを利用することで、特に機密性の高いデバイス資産が確実に不正アクセスから保護されるという安心感が得られます。たとえ盗難者や悪意のある者がデバイスの PIN を知ったとしても、セキュリティが破られることはありません。

現在、Android 15 を搭載した Pixel デバイスへのID チェックのロールアウトが行われています。One UI 7 対応の Galaxy デバイスは、今後数週間以内に利用できるようになります。今年中には、他のメーカーの対応 Android デバイスにもロールアウトされる予定です。

盗難検知ロック: AI を活用した保護を拡大

昨年導入した重要な盗難防止機能の 1 つが、盗難検出ロックです。これは、オンデバイス AI アルゴリズムを活用して、スマートフォンが盗難に遭った可能性を検出する機能です。機械学習アルゴリズムにより、ロックされていないデバイスで盗難に遭った可能性が検知されると、盗んだ人による操作を防ぐため、画面がロックされます。

盗難検知ロックは、世界中の Android 10 以上のスマートフォン² へのロールアウトが完了しています。

Android デバイスの盗難保護

私たちは、GSMA や業界のエキスパートと協力し、情報やツール、予防技術を共有することで、モバイルデバイスの盗難に対抗しています。近日中に GSMA ホワイトペーパーを公開しますので、ご期待ください。モバイル業界と協力して作成したこのホワイトペーパーには、デバイスの盗難から自分自身や組織を保護するための詳しい情報を含める予定です。

Android では、ID チェックの追加と既存機能の継続的な拡張を通し、堅牢で包括的なツールセットを提供することで、デバイスとデータを盗難から保護します。私たちは、個人情報が確かに守られているという安心感を皆さんにお届けする取り組みを続けています。

サポートされている Android デバイスでこちらをクリックすると、新しい Android の盗難保護機能をオンにすることができます。盗難防止機能の詳細については、ヘルプセンターをご覧ください。

注

One UI 7 では、タイミング、対象、機能名が異なる場合があります。 ↩
Android Go スマートフォンを除きます。 ↩

Posted by Eiji Kitamura - Developer Relations Team

【早期登録特典あり】8 月 5 日、6 日 Next Tokyo 東京ビッグサイトにて開催！

2025年2月20日木曜日

クラウドと AI の未来を Next で体感しよう

2025 年 8 月 5 日（火）、 6 日（水）に、旗艦イベント Google Cloud Next Tokyo を開催します。

Next Tokyo は、ビジネスリーダー、イノベーター、エンジニアのためのクラウドカンファレンスです。最新の生成 AI はもちろん、進化する AI エージェントやセキュリティ、アプリ開発、データベース、インフラ、データ分析、生産性とコラボレーションに関するアップデートと、実際に Google Cloud を導入・運用されているお客様の声を基調講演、ライブセッション、展示やハンズオンなど、様々なプログラムを通してお届けします。

クラウドと AI の未来を Next で体感しよう

2025 年 8 月 5 日（火）、 6 日（水）に、旗艦イベント Google Cloud Next Tokyo を開催します。

公式サイトからご登録いただき、Google Cloud の最新技術を、ぜひ会場で体験してください。

先着 1,000 名様に早期登録特典

先着 1,000 名様に Google Cloud を試すための 100 ドル分のクーポンをプレゼントします。

ぜひ、お早めに公式サイトからご登録ください！

※クーポンの利用上限は 100 ドルです。上限を超えると課金されますのでご注意ください。

※他のハンズオンなどでクーポンコードを使用された方は、本クーポンが適用されない場合があります。

ブレイクアウトセッション大募集中

Google Cloud を活用したアプリケーション開発、データ・AI の利活用、従業員同士のコラボレーションなど、企業の課題を解決するナレッジをブレイクアウトセッションにてご紹介いただける方を募集しています。

セッション登壇でスポットライトを浴びて一緒にイベントを盛り上げましょう！

公式サイトよりご応募ください

期日 : 2025 年 3 月 6 日（木）17 時まで

- セッション募集に関するお問い合わせ -

Google Cloud Next Tokyo スピーカー事務局 :
GoogleCloudNextTokyo-Speakers@google.com

開催概要

名称 : Google Cloud Next Tokyo（略称 Next Tokyo）

日時 : 2025 年 8 月 5 日（火）、6 日（水）

会場 : 東京ビッグサイト南展示棟

対象 : 開発者から経営者まで、生成 AI やクラウドテクノロジーを使ってビジネス課題の解決を探求するすべての方

ハッシュタグ : #googlecloudnext

- Next Tokyo に関するお問い合わせ -

Google Cloud Next Tokyo 運営事務局

E-mail: gc-nexttokyo-info@google.com

Ads API での同意の分割について

変更事項

変更事項