--- title: "転送元 - Apple Search Ads | TROCCO Docs" slug: "data-source-apple-search-ads" updated: 2026-08-16T23:42:00Z published: 2026-08-16T23:42:00Z canonical: "documents.trocco.io/data-source-apple-search-ads" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.trocco.io/llms.txt > Use this file to discover all available pages before exploring further. # 転送元 - Apple Search Ads ## 概要 Apple Search Adsのレポートデータを転送する設定のDocsです。 ## 設定項目 ### STEP1 基本設定 | 項目名 | 必須 | デフォルト値 | 内容 | | --- | --- | --- | --- | | Apple Search Ads接続情報 | Yes | - | あらかじめ登録してある[Apple Search Adsの接続情報](/docs/connection-configuration-apple-search-ads)から、今回の転送設定に必要な権限を持つものを選択します。 | | キャンペーングループID | Yes | - | レポート画面左隅のアカウント名のメニューから確認できる、キャンペーングループのIDを入力してください。 ![image.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/data-source-apple-search-ads-2024-08-29-22-59-0.png) | | レポートレベル | Yes | - | レポートレベルを以下から選択します。 - `CAMPAIGNS` - `AD_GROUPS` - `KEYWORDS` - `SEARCH_TERMS` | | 粒度 | Yes | - | 粒度を以下から選択します。 - `HOURLY` - `DAILY` - `WEEKLY` - `MONTHLY` | | データ取得期間 | Yes | - | データ取得期間の開始日と終了日を入力します。 `YYYY-MM-DD`形式で入力してください。 **粒度**の選択内容によって、取得できる期間に条件があります。[データ取得期間の制限](/docs/data-source-apple-search-ads#%E3%83%87%E3%83%BC%E3%82%BF%E5%8F%96%E5%BE%97%E6%9C%9F%E9%96%93%E3%81%AE%E6%9D%A1%E4%BB%B6)を参照ください。 | | タイムゾーン | Yes | UTC | データ取得期間のタイムゾーンを設定します。 レポートレベルで`SEARCH_TERMS`を選択した場合は、`ORTZ`を選択してください。 | #### データ取得期間の条件 **データ取得期間**は、**粒度**によって指定できる期間に制限があります。 - **粒度**が`HOURLY`の場合 転送ジョブ実行時を起点に**開始日**が30日以内の日付、かつ期間が7日以内である必要があります。 - **粒度**が`DAILY`の場合 転送ジョブ実行時を起点に**開始日**が90日以内の日付、かつ期間が90日以内である必要があります。 - **粒度**が`WEEKLY`の場合 転送ジョブ実行時を起点に**開始日**が24か月以内の日付、かつ期間が15日以上365日以内である必要があります。 - **粒度**が`MONTHLY`の場合 転送ジョブ実行時を起点に**開始日**が24か月以内の日付、かつ期間が3か月を超える必要があります。 上記の条件を満たさない期間を指定した場合、実行プレビューおよびジョブ実行時に以下のようなエラーが発生します。 例: **粒度**に`MONTHLY`を、**データ取得期間**に3か月未満の期間を指定した場合 `400POST https://api.searchads.apple.com/api/v5/reports/campaigns/xxxxx/adgroups{"data":null,"pagination":null,"error":{"errors":[{"messageCode":"INVALID_INPUT","message":"Date range of 2023-08-01 to 2023-09-01 is not valid for granularity MONTHLY","field":"request.endTime"}]}}`