メインコンテンツへスキップ
見出し画像
Photo byshunsukesatake

【第40回】 Marketing Cloud REST API 超入門 Part.1 - 基本設定

    Nobuyuki Watanabe

    今回から「Marketing Cloud REST API 超入門」と題して、Marketing Cloud REST API を初めて使う方に向けた基礎的な内容を解説していきます。このシリーズでは、以下のように段階を追って、3つのセクションに分けて説明します。

    ① API 連携のインターフェース設定 ~ Talend API Tester のインストール
    ② 認証サーバーへ「アクセストークン」を要求
    ③ リソースサーバーへ「リクエスト」を送信

    それでは、早速始めましょう。


    ■ API 連携のインターフェース設定

    まずは、Marketing Cloud のセットアップ画面から API 連携のインターフェース設定を行います。

    Marketing Cloud セットアップの左メニューから、プラットフォーム > アプリ の中にある「インストール済みパッケージ」を選択します。

    画像

    続いて、右上にある「新規」ボタンをクリックします。

    画像

    パッケージ名を決めて保存します。このパッケージ名は、API 連携のインターフェース設定の定義名になります。

    画像

    次に「コンポーネントの追加」をクリックします。

    画像

    「API 連携」を選択して、次へをクリックします。

    画像

    「サーバー間」を選択して、次へをクリックします。

    画像

    最後に、スコープ(API で行える権限)を設定します。このスコープが正しく設定されていないと、後のリクエストが成功しません。

    画像

    テスト用途であれば、すべてのスコープにチェックを入れておいても問題ありません。この設定は後から再編集可能です。本番運用時には、必要なスコープだけを選択してください。スコープ設定の詳細は、以下のリンクを参照してください。

    例えば、interaction/v1/events を実行するには、以下の 2 つの Permission ID を設定する必要があります。

    ■ 1018:CONTACTS - List and Subscribers - Read
    ■ 1220:AUTOMATION - Journeys - Read

    すべての設定を完了させると、下の赤く塗りつぶした箇所に、以下の情報が表示さます。

    画像

    ■ クライアント ID
    ■ クライアントシークレット
    ■ 認証ベース URL
    ■ REST ベース URL

    これらの情報は後で使用するので、メモ帳などにコピーして保存してください。また、これらの情報は外部に漏れないよう厳重に管理してください。


    ■ Talend API Tester のインストール

    次に、Google Chrome のウェブストアから Chrome 拡張機能「Talend API Tester」をインストールします。

    現在お使いのパソコンにこの拡張機能をインストールして問題ないか、会社の IT システム部門に確認してください。

    Chrome ウェブストアで「Talend API Tester」を検索し、「Talend API Tester - Free Edition」をインストールします。

    画像
    画像

    インストールが完了したら、Talend API Tester を開きます。

    画像

    Talend API Tester がブラウザ上で開けたら、今回は終了です。


    次回以降の記事では、「② 認証サーバーへ『アクセストークン』を要求」「③ リソースサーバーへ『リクエスト』を送信」を順に実行していきます。

    今回は以上です。


    Click here for English version

    次の記事はこちら

    前回の記事はこちら

    私の自己紹介はこちら

     
     
     
    Salesforce Marketing Cloud、Agentforce、Data Cloud、Salesforce 認定資格に関する実践的な情報を発信しています。これらの記事が、皆さまの学習や日々の業務に少しでもお役に立てば幸いです。