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

mutate 戦略とは、Google 広告スクリプト固有のオブジェクトに依存するのではなく、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);