Google 広告コネクタのトラブルシューティング
ベータ版
この機能はベータ版です。
LakeFlow Connectのマネージド Google Ads コネクタに関する一般的なエラーのトラブルシューティング方法を説明します。
認証は成功しましたが、Google Adsのデータが表示されません
原因: 間違った Google アカウントに認証している可能性があります。または、アカウントが Google 広告にアクセスできない可能性があります。
ソリューション:
- 正しい Google アカウントに認証していることを確認してください。接続を編集して正しいアカウントで再認証するか、接続を再作成して OAuth フローを再評価することができます。
- アカウントに Google 広告へのアクセス権があることを確認します。Google アカウントにログインし、Google 広告データにアクセスする権限があることを確認します。
エラー: GOOGLE_ADS_ACTION_NOT_PERMITTED
エラーメッセージ:
The authenticated Google Ads user or the Google Cloud project that owns the OAuth client is not permitted to perform this action on the requested resource or to call this method (authorization_error: ACTION_NOT_PERMITTED or CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION).
原因: 認証済みユーザーにアカウントへのアクセス権がないか、OAuthクライアントを所有する Google Cloudプロジェクトが Google Ads APIへのテストアクセスしか許可されていないかのいずれかです。テストアクセス権を持つプロジェクトは、本番運用用の Google Adsアカウントを読み取ることができません。
ソリューション:
- 認証されたユーザーが Google Ads アカウントにアクセスできることを確認します。
- OAuthクライアントを所有する Google Cloudプロジェクトのアクセスレベルを確認してください。Google Ads API アクセスレベルの確認を参照してください。 テスト と表示されている場合は、 ベーシック または スタンダード のアクセスを申請してください。
OAuth設定中のリダイレクトURIエラー
エラーメッセージ:
Error: redirect_uri_mismatch
原因: Google Cloud Console OAuthクライアントで構成されたリダイレクト URI がDatabricksワークスペース URL と一致しません。
ソリューション:
- Google クラウド コンソール(https://console.cloud.google.com ) にアクセスします。
- APIsとサービス /> 認証情報」 に移動します。
- OAuth クライアント資格情報をクリックします。
- 「承認済みリダイレクト URI」 の下に、次のパターンが含まれていることを確認します:
https://<workspace-url>/login/oauth/google.html。<workspace-url>Databricks ワークスペースの URL (例:https://dbc-a1b2c3d4-e5f6.cloud.databricks.com) に置き換えます。 - 変更を保存して再度認証を行ってください。
エラー: SAAS_CONNECTION_ERROR.INVALID_CREDENTIALS
エラーメッセージ:
Failed to make a connection to the Google Ads source. Error code: INVALID_OAUTH_CREDENTIALS. Invalid credentials. Ensure the source connection credentials are provided correctly.
原因: Google Adsが接続のOAuth認証情報を拒否しました。例えば、ユーザーがアプリのアクセスを取り消した、ユーザーのパスワードが変更された、またはOAuthクライアントが削除されたなどが考えられます。
ソリューション: 接続を編集し、再認証します。独自の OAuth クライアントを使用している場合は、Google Cloud コンソールにまだ存在していることを確認します。
エラー: GOOGLE_ADS_USER_PERMISSION_DENIED
エラーメッセージ:
The authenticated Google Ads user does not have permission to access the requested customer account (authorization_error: USER_PERMISSION_DENIED). Verify the authenticated user is linked to the account with at least read access.
原因: 認証されたユーザーは、パイプラインが読み取る顧客アカウントにアクセスできません。一般的な原因は、manager_account_idが設定されていない、または顧客アカウントがリンクされているマネージャーアカウントではないことです。これは、アカウントがパイプラインが使用するマネージャーアカウントからリンク解除された、キャンセルされた、他のマネージャーアカウントに移動された、またはユーザーのアクセス権が削除された場合にも発生します。
ソリューション:
- Google Adsで、顧客アカウントがパイプラインで使用するマネージャーアカウントにリンクされていること、および認証済みユーザーがそのアカウントへの読み取り権限以上を持っていることを確認します。
- アカウントが使用できなくなった場合は、パイプラインからそのテーブルを削除してください。それ以外の場合は、アクセス権を持つユーザーで接続を再認証してください。
エラー: GOOGLE_ADS_QUOTA_EXCEEDED
エラーメッセージ:
The Google Ads API quota has been exhausted (rate name: <rateName>, scope: <rateScope>). ...
原因: パイプラインがクォータ制限を超える Google Ads API リクエストを行いました。Google Adsは通常、クライアントにパイプラインの再試行ウィンドウよりも長い待機時間を要求するため、再試行ではなく更新が失敗します。
ソリューション:
- パイプラインが取り込むテーブルの数を減らすか、パイプラインのスケジュール頻度を減らします。
- パイプラインを再実行するまで待ちます。エラーメッセージで再試行の遅延が報告されている場合は、少なくともその時間は待機してください。
0の遅延は、Google Ads が遅延を報告しなかったことを意味します。 - 独自の開発者トークンを使用しており、頻繁にクォータに達する場合は、トークンに高いアクセスレベルを申請してください。Google Ads API ドキュメントのAPI制限とクォータを参照してください。
エラー: GOOGLE_ADS_INVALID_CUSTOM_REPORT_CONFIGURATION
エラーメッセージ:
Invalid custom_report configuration. <reason> ...
原因: カスタムレポートテーブルの custom_report_options にはクエリーを実行できません。理由は問題を指名します。一般的な理由は次のとおりです。
- フィールド名が無効であるか、フィールドを選択した
resourceから選択できません。 - タイムラインセグメントが選択されていません。各カスタムレポートには、
segments.date、segments.week、またはsegments.monthが必要です。 - フィールドは、そのリソースの
resource_nameを持たずに、属性付きリソースから選択されます。 sync_start_dateはsegments.dateまたはsegments.weekでセグメント化されたレポートの37か月以上前のものです。
ソリューション: 理由名を指定するオプションを修正します。データを移動せずに設定をテストするには、databricks pipelines start-update <pipeline-id> --validate-onlyをランします。databricks pipelines start-updateをご覧ください。オプション ルールについては、 「カスタムレポート構成オプション」を参照してください。37ヶ月より古いデータのレポートについては、segments.monthを使用してください。
エラー: GOOGLE_ADS_API_ERROR
エラーメッセージ:
The Google Ads API returned an error (<googleAdsErrorCode>): <googleAdsErrorMessage> ...
原因: Google Ads がエラーでリクエストを拒否しました。コネクタはこれ以上分類しません。エラーコードとメッセージは通常 Google Ads から送信されます。一方、コネクタから送信されるコードもあります。 UNRECOGNIZED_ACCOUNT_TIME_ZONE は、 Google Ads がアカウントのタイムゾーンを返さないか、コネクタが認識できないタイムゾーンを返したことを意味します。そのため、コネクタはアカウントのタイムゾーンでレポートの日付をコンピュートできません。
ソリューション: Google Ads API ドキュメントの「一般的なエラー」ページでエラーコードを調べ、接続または影響を受けるテーブルを調整します。そこにリストされていない UNRECOGNIZED_ACCOUNT_TIME_ZONE の場合、またはエラーが解決しない場合は、Databricks サポートにお問い合わせください。
エラー: MANAGED_INGESTION_PIPELINE_SPEC_VALIDATION_ERROR.OBJECT_SETTING_NOT_SUPPORTED
エラーメッセージ:
These settings are not supported on these <sourceType> objects: <violations>. Remove them from these objects. A table_configuration setting on a table can also come from the pipeline's table_configuration.
原因: パイプラインが、サポートされていないテーブル、スキーマ、またはカタログにオプションを設定しています。たとえば、レポート テーブルの row_filter、primary_keys、または sequence_by、カスタム レポートではないテーブルの custom_report_options、またはリソース テーブルやイベント テーブルの sync_start_date や lookback_window_days などです。エラーには、削除する設定を含む各オブジェクトが一覧表示されます。たとえば ad: lookback_window_days, sync_start_date; campaign_report: row_filter です。
ソリューション: それらのオブジェクトからリストされている設定を削除してください。テーブル自体に row_filter、primary_keys、または sequence_by が設定されていない場合は、パイプラインの table_configuration を確認してください。テーブルに独自の設定がない場合、テーブルはパイプラインからそれらを継承します。lookback_window_days と sync_start_date は、テーブル、スキーマ、またはそれ以外の場合、Google Adsコネクターオプションを設定するパイプライン仕様の最初のテーブルまたはスキーマから取得されます。ルールについては、テーブル構成の制限事項を参照してください。
エラー: MANAGED_INGESTION_CONNECTOR_OPTIONS_CHANGED_REQUIRE_FULL_REFRESH
エラーメッセージ:
The <options> connector option(s) of the <sourceType> destination table `<tableName>` cannot be changed during an incremental update. Perform a full refresh of the table, restore the original options, or create a new destination table.
原因: カスタムレポートの resource、resource_fields、segments、または metrics、あるいはレポートテーブルの sync_start_date を変更しました。これらのオプションはテーブルが保持する行を定義するため、増分更新で変更を適用することはできません。エラーには、変更されたオプションの名前が記載されています。テーブルがそのスキーマから継承する sync_start_date、あるいはパイプライン仕様の最初のテーブルまたはスキーマが Google Ads コネクタ オプションを設定する場合もカウントされます。その値を変更すると、それを継承するすべてのレポートテーブルが失敗する可能性があります。
一部のカスタムレポートの変更は、メトリクスの削除やセグメントの追加など、代わりに SAAS_INCOMPATIBLE_SCHEMA_CHANGES_DURING_INIT で以前に失敗する場合があります。これらにもフル更新が必要です。
解決策 :以下のいずれかを実行します。
- 新しいオプションで再インジェストするには、このテーブルのみの完全更新をランしてください。選択したテーブルを更新する方法については、「ターゲットテーブルを完全に更新する」をご覧ください。完全更新では Google Ads が送信しなくなった履歴が削除されるため、先にその履歴を別のテーブルにコピーしてください。「完全更新後に古い履歴が欠落する」をご覧ください。
- 元のオプションに戻します。
- 新しい構成を新しい送信先テーブルに取り込みます。
エラー: CANNOT_FILTER_OUT_REQUIRED_COLUMN または CANNOT_ADD_COLUMN_TO_INCLUDE_COLUMNS
エラーメッセージ:
Pipeline definition does not include required columns (<columnNames>) in the table <qualifiedTableName> of source <sourceType> for ingestion. Please add them to include_columns or remove them from exclude_columns.
New columns (<columnNames>) are added to include_columns field in pipeline definition for the table <qualifiedTableName>. Please full refresh the table to avoid potential data loss or remove these columns from include_columns.
原因: 列の選択によって、テーブルが必要とする主キーまたはカーソル列が削除されるか、既存のテーブルのinclude_columnsに列が追加されます。前の行には、追加された列の値がありません。
ソリューション: プライマリキーとカーソル列を選択したままにします。既存のテーブルに列を追加するには、そのテーブルのみの完全更新をランするか、include_columns から新しい列を削除します。選択したテーブルを更新するには、「ターゲットテーブルを完全に更新する」を参照してください。完全更新では Google Ads が提供しなくなった履歴が削除されるため、その履歴を先に別のテーブルにコピーしてください。「完全更新後に古い履歴が欠落している」を参照してください。
レポートテーブルに Google Adsと一致しなくなった値があります
原因: Google Ads がルックバックウィンドウより古いデータを変更したか、行を全ゼロのメトリクスとして再設定しました。コネクタはルックバックウィンドウのみを再読み込みし、レポート行を削除しないため、テーブルは以前の値を保持します。「 データの遅延変更と削除された行の制限 」を参照してください。
ソリューション:
- 影響を受ける行を1回更新するには、そのテーブルのみの完全更新をランします。選択したテーブルを更新するには、「ターゲットテーブルを完全に更新する」を参照してください。完全更新を行うと、Google Adsが提供しなくなった履歴が削除されるため、その履歴を最初に別のテーブルにコピーしてください。「完全更新後に古い履歴が欠落する」を参照してください。
- 変更がルックバック期間より遅れて届くことが多い場合は、
lookback_window_daysをコンバージョン期間に合わせて増やしてください。
完全更新後に古い履歴がない
原因: 完全更新は、Google Adsが現在提供しているデータのみを取り込みます。Google Adsは、時間単位、日単位、週単位のレポートデータを37か月間、クリックデータを90日間、リードフォームの送信データを60日間保持します。それより古い履歴はテーブルから削除されます。データ保持の制限を参照してください。
ソリューション:
- 完全更新の前にテーブルのコピーを保持していた場合は、そのコピーから以前の履歴を復元してください。
- コピーがない場合は、Databricks サポートに問い合わせてリカバリオプションを評価してください。
- 将来の完全更新の前に、Google Ads が配信しなくなった履歴を別のテーブルにコピーします。
- 37か月より古いデータが必要なカスタムレポートについては、
segments.monthを使用します。これは、これらの期間の月次合計を返します。元の時間別、日別、または週別の行は復元されません。
click_report パイプラインが一時停止された後にクリックが欠落しています
原因: Google Adsではクリックデータが直近90日分のみ提供され、コネクタが読み取るのは直近88日分までです。パイプラインが88日を超えて正常にランされない場合、最後に正常に更新された時点から88日前までのクリックデータは取り込めません。
ソリューション: 欠落した日付を回復することはできません。スケジュールに従ってパイプラインをランし、最後の更新から88日が経過する前に失敗した更新を修正してください。