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

ミューテート戦略とは、 AdsApp.mutateを使用して API 呼び出しを 直接行うことを指します。これにより、API のすべての機能にすばやくアクセスできるというメリットがあります。また、API の構文に慣れている場合は、参入障壁が低くなります。Google 広告スクリプトを使用してデマンド ジェネレーション キャンペーンを変更するには、この方法しかありません。

ミューテートを使用してデマンド ジェネレーション キャンペーンを作成する

このガイドでは、個々のエンティティを別々のリクエストで作成するのではなく、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 ドキュメントをご覧ください。デマンド ジェネレーションキャンペーンの 必須コンポーネントと省略可能なコンポーネントについて学習し、ニーズに合わせてオペレーションを作成します。

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

AdsApp.mutateAll(operations);