リクエスト フォーマット
新しい Search Ads 360 Reporting API のリクエスト形式は、実行するリクエストの種類によって異なります。以前の API では、同期または非同期リクエストを使用して、事前定義されたレポートタイプをリクエストできました。
検索
新しい API では、ニーズに合わせて検索クエリを定義することで、検索結果をカスタマイズできます。検索広告 360 のクエリ言語を使用すると、すべてのリソースを検索して、特定の条件に合致するエンティティのリストを取得できます。すべてのリクエストは、エンティティ タイプに関係なく SearchAds360Service
に対して行われます。詳しくは、検索レポートを作成すると検索広告 360 のクエリ言語をご覧ください。
回答の形式
新しい API では、レスポンスに入力されるフィールドは、使用するサービスによって異なります。
SearchAds360Service
- レスポンスには、検索パラメータに一致するエンティティごとに 1 つの
SearchAds360Row
オブジェクトが含まれます。各行には 1 つのオブジェクト(キャンペーンなど)が含まれ、クエリでリクエストしたフィールドのみが含まれます。 - 特定のサービス
- リソース名で一度にリクエストできるエンティティは 1 つだけです。レスポンスには、そのエンティティのすべてのフィールドが含まれます。
お客様 ID のフォーマット
新しい API では、お客様 ID をダッシュなしの 10 桁の数字(XXXXXXXXXX
)で指定する必要があります。