Mutate

変更戦略とは、 AdsApp.mutateを使用して直接 API 呼び出しを行うのではなく、Google 広告スクリプト固有のオブジェクトに依存することを指します。これにより、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);