このページでは、CData Cloud でのPinterest への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。

Pinterest への接続

接続の確立 は、CData Cloud にデータベースを作成するためのPinterest への認証方法と必要な接続プロパティの設定方法について示します。

CData Cloud サービスからデータにアクセス

利用可能な標準サービスを経由してPinterest からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。

Database タブで対応するアイコンを選択して、Pinterest に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。

Pinterest への接続

以下のサブセクションでは、3つの一般的な認証フローでのPinterest への認証について詳しく説明します。

• デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。
• Web：共有ウェブサイト経由でデータにアクセスします。
• ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。

カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成 を参照してください。

Pinterest で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

OAuth アクセストークンの自動リフレッシュ：

Cloud がOAuth アクセストークンを自動的にリフレッシュするようにするには：

1. はじめてデータに接続する前に、次の接続パラメータを設定します。
   • InitiateOAuth：REFRESH。
   • OAuthClientId：カスタムOAuth アプリケーション設定のクライアントId。
   • OAuthClientSecret：カスタムOAuth アプリケーション設定のクライアントシークレット。
   • OAuthAccessToken：GetOAuthAccessToken によって返されたアクセストークン。
   • OAuthSettingsLocation：Cloud がOAuth 値を保存する場所のパス。これは接続間で維持されます。
2. その後のデータ接続では、以下を設定します。
   • InitiateOAuth
   • OAuthSettingsLocation

OAuth アクセストークンの手動リフレッシュ：

OAuth アクセストークンを手動でリフレッシュするために必要な唯一の値は、OAuth リフレッシュトークンです。

1. ExpiresIn 期間（GetOAuthAccessToken が返す）が経過した後にOAuthAccessToken を手動でリフレッシュするには、RefreshOAuthAccessToken ストアドプロシージャを呼び出します。
2. 次の接続プロパティを設定します。
   • OAuthClientId：カスタムOAuth アプリケーション設定のクライアントId。
   • OAuthClientSecret：カスタムOAuth アプリケーション設定のクライアントシークレット。

3. RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを設定します。
4. 新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定します。これで新規接続が開かれます。

OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

カスタムOAuth アプリケーションの作成

手順

1. https://developers.pinterest.com/apps/ に移動します。
2. Pinterest アカウントにログインします。
3. Create app をクリックします。
4. Name およびDescription を指定します。
5. Create をクリックします。
6. フォームに必要事項を記入します。
   • Auth Callback URL をhttps://localhost:33333 か任意の別のポートに設定します。
   • カスタムアプリケーションに複数のユーザーがアクセスできるか、またはオーナーのみがアクセスできるかを指定します。

7. 変更を保存します。Pinterest Developers Portal は、新しいカスタムOAuth アプリケーションを作成します。

アプリケーションの作成が完了すると、Developers Portal に確認メッセージが表示されます。新しいカスタムアプリケーションのClient ID とClient Secret を表示するには、 View Client ID をクリックします。

後で使用するために、これらの設定を記録しておきます。

概要

このセクションでは、利用可能なAPI オブジェクトを示し、Pinterest API へのSQL の実行について詳しく説明します。

主要機能

• Cloud はボード、フォロワー、およびピンなどのPinterest エンティティをリレーショナルビューとしてモデル化し、SQL を記述してPinterest データをクエリできるようにします。
• ストアドプロシージャを使用すると、Pinterest への操作を実行できます。
• これらのオブジェクトへのライブ接続により、Cloud を使用するとPinterest アカウントへのあらゆる変更が即座に反映されます。

ビュー

ビュー では、利用可能なビューを説明します。ビューは、ボード、フォロワー、ピンなどを静的にモデル化するように定義されています。

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

CData Cloud - Pinterest ビュー

Get analytics for the specified AdAccountId

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• StartDate supports the '=,>,>=' operator.
• EndDate supports the '=,<,<=' operator.
• Granularity supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• ConversionReportTime supports the '=' operator.

	
	SELECT * FROM AdAccountAnalytics WHERE AdAccountId = '3457832451'
    SELECT * FROM AdAccountAnalytics WHERE AdAccountId = '3457832451' and StartDate >= '2024-01-06' and EndDate <= '2024-04-05'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get the ad account analytics report

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• StartDate supports the '=' operator.
• EndDate supports the '=' operator.
• Granularity supports the '=' operator.
• Level supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• ConversionReportTime supports the '=' operator.
• AttributionTypes supports the '=' operator.
• CampaignIds supports the '=,IN' operator.
• CampaignStatuses supports the '=,IN' operator.
• CampaignObjectiveTypes supports the '=' operator.
• AdGroupIds supports the '=,IN' operator.
• AdGroupStatuses supports the '=' operator.
• AdIds supports the '=,IN' operator.
• AdStatuses supports the '=' operator.
• ProductGroupIds supports the '=,IN' operator.
• ProductGroupStatuses supports the '=,IN' operator.
• TargetingTypes supports the '=,IN' operator.
• ProductItemIds supports the '=,IN' operator.

	
	SELECT * FROM AdAccountAnalyticsReport WHERE AdAccountId = '3457832451' AND Level = 'advertiser'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get a list of the ad_accounts that the User has access to.

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• IncludeSharedAccounts supports the '=' operator.
• Id supports the '=' operator.

	SELECT * FROM AdAccounts

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get targeting analytics for an ad account.

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• StartDate supports the '=,>,>=' operator.
• EndDate supports the '=,<,<=' operator.
• Granularity supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• TargetingTypes supports the '=' operator.

	
	SELECT * FROM AdAccountTargetingAnalytics WHERE AdAccountId = '3457832451'
    SELECT * FROM AdAccountTargetingAnalytics WHERE AdAccountId = '3457832451' and StartDate >= '2024-01-06' and EndDate <= '2024-04-05'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get analytics for the ads in the specified AdAccountId

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• AdId supports the '=,IN' operator.
• StartDate supports the '=,>,>=' operator.
• EndDate supports the '=,<,<=' operator.
• Granularity supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• ConversionReportTime supports the '=' operator.

	
	SELECT * FROM AdAnalytics WHERE AdAccountId = '3457832451' AND AdId = '3457862457'
        SELECT * FROM AdAnalytics WHERE AdAccountId = '3457832451' and StartDate >= '2024-01-06' and EndDate <= '2024-04-05'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get analytics for the specified campaigns in the specified AdAccountId

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get analytics for the ad groups in the specified AdAccountId

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• AdGroupId supports the '=,IN' operator.
• StartDate supports the '=,>,>=' operator.
• EndDate supports the '=,<,<=' operator.
• Granularity supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• ConversionReportTime supports the '=' operator.

	
	SELECT * FROM AdGroupAnalytics WHERE AdAccountId = '3457832451' AND AdGroupId = '3457862457'
    SELECT * FROM AdGroupAnalytics WHERE AdAccountId = '3457832451' and StartDate >= '2024-01-06' and EndDate <= '2024-04-05'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get a list of the ad_accounts that the User has access to.

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• Id supports the '=,IN' operator.
• Status supports the '=' operator.
• TranslateInterestsToNames supports the '=' operator.

	
	SELECT * FROM AdGroups WHERE AdAccountId = '3457832451'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Get targeting analytics for one or more ad groups.

Table Specific Information

Select

The Cloud will use the Pinterest API to process WHERE clause conditions built with the following column and operator. The rest of the filter is executed client side within the Cloud.

• AdAccountId supports the '=' operator.
• AdGroupId supports the '=,IN' operators.
• TargetingType supports the '=' operator.
• StartDate supports the '=,>,>=' operator.
• EndDate supports the '=,<,<=' operator.
• Granularity supports the '=' operator.
• ClickWindowDays supports the '=' operator.
• EngagementWindowDays supports the '=' operator.
• ViewWindowDays supports the '=' operator.
• ConversionReportTime supports the '=' operator.

	
	SELECT * FROM AdGroupTargetingAnalytics WHERE TargetingType = 'LOCATION'
    SELECT * FROM AdGroupTargetingAnalytics WHERE AdAccountId = '3457832451' and StartDate >= '2024-01-06' and EndDate <= '2024-04-05'

Columns