ヘッドレスマシン

ヘッドレスマシンでのOAuth の使用

ヘッドレスサーバーや、本製品がブラウザを開くことができないその他のマシンにSnapchat Ads データソースを作成するには、別のマシンから認証を行う必要があります。以下に説明するように、認証は2段階認証プロセスになります。

本製品を別のマシンにインストールする代わりに、このセクションで説明する手順に従ってOAuthVerifier 値を取得できます。または、別のマシンに本製品をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送することもできます。
その後、ヘッドレスマシンからアクセストークンを自動的にリフレッシュするように本製品を設定します。

本製品の埋め込みOAuth クレデンシャルを使用するか、カスタムOAuth アプリのOAuth クレデンシャルを使用して、ヘッドレスOAuth 認証フローに従うことができます。

埋め込みOAuth クレデンシャルの使用

このセクションでは、埋め込みOAuth クレデンシャルを使用する手順について説明します。

Verifier code を取得

別のマシンから認証してOAuthVerifier 接続プロパティを取得するには、次の手順を実行してください。

次のリンクをクリックして Snapchat Ads OAuth endpoint ブラウザで開きます。
ログインして、本製品にアクセス許可を与えます。すると、verifier code を含むコールバックURL にリダイレクトされます。
verifier code の値を保存します。これをOAuthVerifier 接続プロパティに設定します。

ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。

OAuthVerifier：verifier code に設定。
InitiateOAuth：REFRESH に設定。
OAuthSettingsLocation：暗号化されたOAuth 認証値を指定されたファイルに永続化。

OAuth 設定ファイルが生成されたら、次のプロパティを設定してデータに接続します。

OAuthSettingsLocation：暗号化されたOAuth 認証値を含むファイルに設定。アクセストークンの自動リフレッシュを有効にするために、このファイルが本製品に読み書きのアクセス許可を与えることを確認してください。
InitiateOAuth：REFRESH に設定。

OAuth 設定を転送

別のマシンに本製品をインストールして、認証してから結果のOAuth 値を転送するには、次の手順を実行してください。

セカンドマシンに、本製品をインストールして、次の接続プロパティセットで接続します。

OAuthSettingsLocation：書き込み可能なテキストファイルに設定。
InitiateOAuth：GETANDREFRESH に設定。

ブラウザで認証する接続をテストします。生成された認証値は、OAuthSettingsLocation で指定されたパスに暗号化されて書き込まれます。接続が正常にテストされたら、OAuth 設定ファイルをヘッドレスマシンにコピーします。

ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。

InitiateOAuth：REFRESH に設定。
OAuthSettingsLocation：OAuth 設定ファイルのパスに設定。アクセストークンの自動リフレッシュを有効にするために、このファイルが本製品に読み書きのアクセス許可を与えることを確認してください。

カスタムOAuth アプリのクレデンシャルの使用

このセクションでは、カスタムOAuth アプリのクレデンシャルを使用する方法を説明します。

カスタムOAuth アプリの作成

ヘッドレスOAuth フローでは、カスタムOAuth アプリの作成は任意です。本製品の埋め込みOAuth クレデンシャルで接続することで、アプリの作成をスキップできます。カスタムOAuth アプリを作成して、ユーザーがSnapchat Ads にログインして本製品にアクセス権を与えるときに表示される情報を変更することもできます。手順についてはカスタムOAuth アプリの作成を参照してください。下記の手順に従って、データの認証および接続を行うことができます。