mutate 戦略を使用して Google Ads API 呼び出しを行う

mutate 戦略とは、 AdsApp.mutateを使用して API 呼び出しを 直接行うことを指します。これにより、API のすべての機能にすばやくアクセスできるというメリットがあります。また、API の構文に慣れている場合は、参入障壁が低くなります。

mutate を使用して P-MAX キャンペーンを作成する

このガイドでは、個々のエンティティを別々のリクエストで作成するのではなく、1 つのアトミックなリクエストでキャンペーン全体を作成することを前提としています。つまり、リソースを相互にリンクするために、一時的な ID を設定して使用する必要があります。

準備ができたら、すべてのオペレーションを保持する配列を作成します。

const operations = [];

すべてのリソース名で必要となるため、キャンペーンを作成する顧客の顧客 ID が必要になることがよくあります。

const customerId = AdsApp.currentAccount().getCustomerId();

新しいリソースを作成するたびに、リソース名で次の一時 ID を使用します。これにより、後でこのオブジェクトを参照し、作成したオブジェクトを配列に挿入できます。

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

詳細とオペレーションの例については、 Google Ads API REST mutate のドキュメントをご覧ください。P-MAX キャンペーンの 必須コンポーネントと省略可能なコンポーネント について学習し、ニーズに合わせてオペレーションを作成します。

すべてのオペレーションを作成したら、1 つのバッチで実行します。

AdsApp.mutateAll(operations);