LINQ を使ってShort.io のデータに連携する方法
この記事では、CData ADO.NET Data Provider for API 経由でLINQ を使ってShort.io テーブルにアクセスする方法を説明します。これを行うには、Entity Framework にLINQ を使います。これにより接続を作成し、あらゆる CData ADO.NET Data Providers からLINQ を使ってデータにアクセスできるようになります。
- Visual Studio の新規プロジェクトで、プロジェクトを右クリックし[新しい項目の追加]を選択します。[ADO.NET Entity Data Model]を追加します。
- [データベースから生成]を選択し、[次へ]をクリックします。
- [接続の追加]をクリックし、データソースタイプを "CData Short.io Data Source" に変更します。
データソースの接続情報を入力します。一般的な接続プロパティは以下のとおりです:
API キー認証の設定
Short.io は API キー認証を使用します。API キーを取得するには、以下のステップで進めます:
- Short.io アカウントにログインします
- Settings > Integrations & API > API に移動します
- Create API Key をクリックして API キーをコピーします
API キーを取得したら、接続を確立できます:
- AuthScheme:APIKey に設定します。
- APIKey:Settings > Integrations & API > API から取得した Short.io の API キーに設定します。
接続文字列の例:
Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
利用可能なテーブル
Short.io プロファイルでは、以下のテーブルにアクセスできます:
- Domains - 認証済みアカウントに関連付けられた Short.io ドメイン
- Links - ドメインの短縮リンク
- LinkExpand - ドメインとパスから短縮リンクを展開
- LinksByOriginalUrl - 指定した元の宛先 URL に一致する複数の短縮リンクを取得
- Folders - 特定のドメイン内のリンクフォルダー
- LinkPermissions - ドメイン内の特定のリンクの権限レコード
- CountryTargeting - 特定の短縮リンクの国別リダイレクトターゲティングルール
- RegionTargeting - 特定の短縮リンクの地域別リダイレクトターゲティングルール
- Regions - 指定した国コードに対する利用可能な地域/州の一覧
- DomainStatistics - Short.io ドメインのクリック数とトラフィックの集計統計
- LinkStatistics - 特定の Short.io リンクのクリック数とトラフィックの集計統計
Below is a typical connection string:
Profile=C:\profiles\ShortIo.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key';
- エンティティ接続をApp.Config に保存する場合は、エンティティ名を設定します。この例では、APIEntities をエンティティ接続としてApp.Config に設定しています。
- モデル名を入力し、モデルに含めたいテーブルまたはビューを選択します。
作成したエンティティを使って、選択、更新、削除、および挿入コマンドが実行できます。例:
APIEntities context = new APIEntities();
var domainsQuery = from domains in context.Domains select domains;
foreach (var result in domainsQuery) {
Console.WriteLine("{0} {1} ", result.Id, result.);
}
サポートされたLINQ のクエリ例は、ヘルプドキュメントの「LINQ およびEntity Framework」をご参照ください。