カスタムOAuth アプリを使用するタイミング

接続にはカスタムOAuth アプリの作成が必須です。

カスタムOAuth アプリを作成して、ユーザーがTwitter Ads にログインして本製品 にアクセス権を与えるときに表示される情報を変更することもできます。

カスタムOAuth アプリでのデスクトップ認証

下記の手順に従って、カスタムOAuth アプリの資格情報を使用して認証します。詳しくは、カスタムOAuth アプリの作成 を参照してください。

OAuth アクセストークンの取得およびリフレッシュ

次の接続プロパティを設定して、接続してください。

• OAuthClientId：アプリケーション設定のコンシューマーキーに設定。
• OAuthClientSecret：アプリケーション設定のコンシューマーシークレットに設定。
• CallbackURL：独自のOAuth アプリを使用するために指定したOAuth リダイレクトURL に設定。
• InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動でのOAuthAccessToken 接続プロパティの設定の繰り返しを避けられます。

接続すると、本製品 はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 本製品 はこれでOAuth プロセスを完了します。

1. コールバックURL からアクセストークンを取得し、リクエストを認証します。
2. アクセストークンの期限が切れたときにはリフレッシュしてください。
3. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。

Web アプリケーションからTwitter Ads へ認証

Web アプリケーションから接続する場合、または本製品 にブラウザウィンドウを開く権限がない場合は、ストアドプロシージャを使用して、InitiateOAuth を設定して一時的なOAuth トークンを管理します。

アクセストークンの取得

次の接続プロパティを設定し、アクセストークンを取得します。

• OAuthClientId：受け取ったClientId に設定。
• OAuthClientSecret：受け取ったClientSecret に設定。

これらのプロパティを設定した状態で、以下の手順に従ってストアドプロシージャを呼び出し、OAuthAccessToken を取得します。

1. GetOAuthAuthorizationURL を呼び出します。ストアドプロシージャは、リクエストトークンおよびシークレットとともにOAuth エンドポイントのURL を返します。

2. そのURL に移動し、ログインしてアプリケーションを認可します。その後、コールバックURL にリダイレクトされます。

   リダイレクトされたときに、コールバックURL は、code クエリ文字列パラメータを保有しています。

3. 次のパラメータを設定し、GetOAuthAccessToken を呼び出します：

   Name	Value
   AuthMode	WEB
   Verifier	verifier code に設定。

データへの接続

データのリクエストを認証するには、次のように設定します。

• OAuthAccessToken：これをGetOAuthAccessToken ストアドプロシージャによって返されたOAuthAccessToken に設定します。

トークンのリフレッシュ

InitiateOAuth をREFRESH に設定すると、アクセストークンの期限が切れたときに自動でリフレッシュできます。

データに接続してOAuthAccessToken を自動的にリフレッシュするには、最初のデータ接続で次のように設定します。

• InitiateOAuth
• OAuthSettingsLocation
• OAuthClientId
• OAuthClientSecret
• OAuthAccessToken
• OAuthRefreshToken

その後のデータ接続では、次を設定します。

• InitiateOAuth
• OAuthSettingsLocation