Pinterest への接続を追加

1. アプリケーションコンソールで、接続ページに移動します。
2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
3. Pinterest アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからPinterest コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Pinterest への接続

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

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

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

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

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

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

1. はじめてデータに接続する前に、次の接続パラメータを設定します。
   • InitiateOAuth：REFRESH。
   • OAuthClientId：カスタムOAuth アプリケーション設定のクライアントId。
   • OAuthClientSecret：カスタムOAuth アプリケーション設定のクライアントシークレット。
   • OAuthAccessToken：GetOAuthAccessToken によって返されたアクセストークン。
   • OAuthSettingsLocation：Sync App が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 アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

概要

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

主要機能

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

ビュー

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

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

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

Pinterest Connector for CData Sync ビュー

Get analytics for the specified AdAccountId

Table Specific Information

Select

The Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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 Sync App 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 Sync App.

• 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