転送構成のトラブルシューティング

このドキュメントは、転送を設定する際に発生する一般的な問題のトラブルシューティングに役立つ情報を提供します。発生のおそれがあるすべてのエラー メッセージや問題がこのドキュメントに網羅的に記載されているわけではありません。

このドキュメントに記載されていない問題が発生した場合は、サポートをご依頼ください。

実行履歴からエラーを調べる

初期転送実行が失敗した場合は、実行履歴の詳細を調べます。このドキュメントを使用することで、実行履歴にリストされるエラーを適切な解決策の特定に利用できます。

Google Cloud サポートへのお問い合わせの前に、実行履歴からエラー メッセージなどの関連情報を取得してください。

一般的な問題

一般的な転送の問題を診断する場合は、次の点を確認してください。

  • 該当する転送タイプのドキュメント ページの「始める前に」のセクションにあるすべての手順を完了していること。
  • 転送構成のプロパティが正しく設定されていること。
  • 転送を作成するために使用されたユーザー アカウントに、基になるリソースへのアクセス権が付与されていること。
  • 従来の BigQuery ウェブ UI を使用して転送を作成する場合は、権限ウィンドウが表示されるように、bigquery.cloud.google.com からのポップアップを許可します。転送を成功させるには、BigQuery Data Transfer Service 権限にデータの管理を許可する必要があります。

転送構成が適切で、適切な権限が与えられている場合は、以下に示すよくある問題の解決方法を参照してください。

エラー: An unexpected issue was encountered. If this issue persists, please contact customer support.
解決策: このエラーは、通常、一時的な停止または BigQuery 内の問題を示します。問題が解決するまで約 2 時間待ちます。問題が解決しない場合は、サポートを依頼してください。
エラー: Quota Exceeded.
解決策: 転送は、BigQuery 読み込みジョブの割り当ての対象となります。割り当てを増やす必要がある場合は、Cloud 営業担当者にお問い合わせください。詳細については、割り当てと上限をご覧ください。

Campaign Manager の転送に関する問題

Campaign Manager の転送を作成する際によくあるエラーは次のとおりです。

エラー: Import failed - no data was available for import. Please verify that data existence was expected.
エラー: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.
解決策: 転送に正しい ID を使用していることを確認してください。正しい ID を使用している場合は、指定した日付範囲の Data Transfer V2.0 ファイルが Campaign Manager Cloud Storage バケットに含まれていることを確認します。ファイルが存在する場合は、該当する日付範囲のバックフィルをスケジュールします。キャンペーン マネージャーのバックフィル リクエストの作成方法の詳細は、バックフィルの設定をご覧ください。
エラー: A permission denied error was encountered: PERMISSION_DENIED. Please ensure that the user account setting up the transfer config has the necessary permissions, and that the configuration settings are correct.
解決策: キャンペーン マネージャーの転送を作成するユーザーには、Data Transfer V2.0 ファイルが格納されている Cloud Storage バケットに対する読み取りアクセス権が必要です。Cloud Storage バケットと、アクセスのリクエストに関する情報は、Google アド マネージャー管理者から取得できます。

Google 広告の転送を作成する際によくあるエラーは次のとおりです。

エラー: Import failed - no data was available for import. Please verify that data existence was expected.
エラー: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.
解決策: Google 広告の転送を作成しているときにこのエラーが発生した場合は、サポートをご依頼のうえ、エラー メッセージの画面キャプチャを送付してください。
エラー: AuthenticationError.NOT_ADS_USER.
解決策: Google 広告の転送を構成するユーザーには、Google 広告アカウントおよびログイン情報が必要です。
エラー: ERROR_GETTING_RESPONSE_FROM_BACKEND.
解決策: Google 広告の転送実行が失敗して、ERROR_GETTING_RESPONSE_FROM_BACKEND が返された場合は、転送構成で [Exclude Removed/Disabled Items] オプションを有効化します。バックフィルを設定して、失敗した転送実行の影響を受けた日のデータの取得を試みます。

Google アド マネージャーの転送を作成する際によくあるエラーは次のとおりです。

エラー: No data available for the requested date. Please try an earlier run date or verify that data existence was expected.
エラー: Import failed - no data was available for import. Please verify that data existence was expected.

解決策: Google アド マネージャーの Cloud Storage バケットに、指定した日付範囲の Data Transfer ファイルが含まれていることを確認します。ユーザーの Data Transfer ファイルが含まれている Cloud Storage バケットは、Google アド マネージャー管理者が管理しています。Google アド マネージャーの転送を作成するユーザーは、バケットの読み取りアクセス権を持つ Google グループのメンバーである必要があります。

Cloud Storage のアクセス許可は、Google アド マネージャーの Data Transfer バケット内のファイルの読み込みを試してみることで検証できます。Google アド マネージャーの Cloud Storage バケットの詳細については、Google アド マネージャーのストレージ バケットにアクセスするを参照してください。

ファイルが Data Transfer バケットに存在しており、読み取り権限がある場合は、影響を受ける日付範囲のバックフィルをスケジュールします。Google アド マネージャーのバックフィル リクエストの作成の詳細については、バックフィルの設定を参照してください。

エラー: AuthenticationError: NO_NETWORKS_TO_ACCESS.

解決策: Google アド マネージャー ネットワークへの読み取りアクセス権があることを確認してください。ネットワーク アクセスの判定に関してご不明な点がありましたら、Google アド マネージャーのサポートにお問い合わせください。

エラー: Error code 9 : Field field_name?field_name?field_name?RefererURL is unknown.; Table: table_name

解決策: ソーン(þ)区切り文字を使用していないことを確認します。ソーン区切り文字は現在サポートされていません。ソーンが使用されていることは、エラー メッセージの中で ? により示されています。

Google Merchant Center の転送に関する問題

Google Merchant Center の転送を作成する際によくあるエラーは次のとおりです。

エラー: No data to transfer found for the Merchant account. If you have just created this transfer - you may need to wait for up to 90 minutes before the data of your Merchant account are prepared and available for the transfer.
解決策: [スケジュール] セクションでデフォルトの開始日時を使用して転送を設定すると、このエラーが発生します。スケジュールのデフォルト値を使用した場合、転送の作成直後に最初の転送が開始しますが、転送前に販売アカウントの準備が必要なため、転送に失敗します。90 分待ってから当日のバックフィルを設定するか、翌日に次回のスケジュールされた転送が実行されるまで待ちます。
エラー: No data to transfer found for Merchant account. This can be because your account currently doesn't have any products.
解決策: このエラーは、販売アカウントに商品がないことを示しています。販売アカウントに商品を追加すると、転送が始まります。
エラー: Transfer user doesn't have access to the Merchant account. Please verify access in the Users section of the Google Merchant Center.
解決策: このエラーは、転送を設定したユーザーに、転送で使用される販売アカウントに対するアクセス権がないことを示します。問題を解決するには、Google Merchant Center でアカウントへのアクセス権を確認し、不足している権限を付与します
エラー: Transfer user doesn't have user roles that allows access to the product data of the Merchant account. Please verify access and roles in the Users section of the Google Merchant Center.
解決策: このエラーは、転送を設定したユーザーに、転送で使用される販売アカウントの商品データに対するアクセス権がないことを示します。問題を解決するには、Google Merchant Center でユーザーの役割を確認し、不足している役割を割り当てます
エラー: Historical backfills are currently not supported.
解決策: このエラーは、前日のバックフィルを設定すると発生します。これは予想されるエラーです。現在のところ、過去のバックフィルはサポート対象外です。設定できるのは当日のバックフィルのみで、毎日の実行スケジュールが完了した後に当日のデータを更新できます。

YouTube の転送に関する問題

YouTube 転送を作成する際によくあるエラーは次のとおりです。

エラー: Import failed - no data was available for import. Please verify that data existence was expected.
エラー: No data available for requested date. Please try an earlier run date or verify that data existence was expected.

解決策: これまでに YouTube のレポート作成ジョブを作成したことがない場合は、BigQuery Data Transfer Service によってレポートが生成されるまで少なくとも 2 日間お待ちください。追加のアクションは必要はありません。 転送は最初の 2 日間は失敗し、3 日目に成功するはずです。以前に YouTube のレポート作成ジョブを作成した場合は、そのレポートを作成したユーザーに、レポート読み取りアクセス権限があることを確認します。

また、転送が正しいアカウントに設定されていることを確認します。OAuth ダイアログで、データを読み込むチャンネルを選択する必要があります。

エラー: No reports for reporting job with name name.

解決策: これはエラーではありません。指定したレポートのデータが見つからないことを示す警告です。この警告は無視できます。以降の転送は引き続き実行されます。

問題: 転送によって作成されたテーブルが不完全であるか、予期しない結果になる。
解決策: 複数のアカウントをお持ちの場合は、YouTube の権限ダイアログが表示されたら、正しいアカウントを選択する必要があります。

YouTube 権限の問題

YouTube コンテンツ マネージャ レポートの場合、転送を設定するユーザーには(少なくとも)CMS user 権限が必要です。CMS user 権限は、転送の作成対象となる各コンテンツ マネージャに付与する必要があります。

割り当ての問題

エラー: Quota exceeded: Your project exceeded quota for imports per project.
解決策: プロジェクトに対して転送を過剰にスケジュールしていないことを確認します。転送によって開始される読み込みジョブの数を計算する方法については、割り当てと上限をご覧ください。