クエリーの作成

GETコールから返ってくるデータの数を制限するには、whereクエリーを指定することができます。

説明

whereとクエリーについての考察:
  • クエリーはURLエンコードしてください。
  • 値がnullのプロパティを検索することはできません。
  • クエリーはすべてのキーワードを含むプロバイダーの結果を返します。クエリーは 大文字・小文字を無視し、単数形・複数形両方の用語を返し、"a" や"the"といった一般的な単語を 無視します。たとえば、notes='sports'は以下を返します。
    • "Sports fan"
    • "Not a good sport"
    • "Company involved in sports"
  • 削除されたアセットは、クエリー結果には返ってきません。

比較オペレーター

整数と文字列フィールドには、すべての比較オペレーターがサポートされます。 < <=, =, >, >=!=。たとえば、次の例では90000の範囲以上のアメリカの 郵便番号を持つすべてのプロバイダーを返します。

[GET] /v2/providers?where=zip > 89999
    

この例は英国ロンドンのプロバイダーを返します。

[GET] /v2/providers?where=country = 'England' AND city = 'London'
    

Backlot は次のようなレスポンスを返します。

{
 "items": [   {
   "package_id": "7370e1f93aa24f5aafafc1abb6418b55",
   "name": null,
   "pcode": "pzd3M6WH2DENHKruXzs4nGI52AaY",
   "address": {
    "city": "London",
    "zip": "W11 2BQ",
    "country": "England",
    "street": "221B Baker St."
   },
   "created_at": "2012-02-08T19:52:28+00:00",
   "bucket": "http://uploader.ooyala.com",
   "admin_user_email": null,
   "notes": null,
   "phone_numbers": {
    "phone": "44-20-1234-5678"
   },
   "processing_profile_id": "81165e8d535c4f678784280218b26bff",
   "secret": "RSr3ZSmAG8Y0HW6PfNaiR4hxgadmQxrAwhlZONul",
   "status": "live"
  }  ]
}
    

この例は指定されたメールアドレスのプロバイダーを返します。

[GET] /v2/providers?user=someuser@mycompany.com
    

Backlot は次のようなフィードを生成します。

{
 "items": [   {
   "package_id": "7370e1f93aa24f5aafafc1abb6418b55",
   "name": null,
   "pcode": "pzd3M6WH2DENHKruXzs4nGI52AaY",
   "address": {
    "city": "London",
    "zip": "W11 2BQ",
    "country": "England",
    "street": "221B Baker St."
   },
   "created_at": "2012-02-08T19:52:28+00:00",
   "bucket": "http://uploader.ooyala.com",
   "admin_user_email": null,
   "notes": null,
   "phone_numbers": {
    "phone": "44-20-1234-5678"
   },
   "processing_profile_id": "81165e8d535c4f678784280218b26bff",
   "secret": "RSr3ZSmAG8Y0HW6PfNaiR4hxgadmQxrAwhlZONul",
   "status": "live"
  }  ]
}
    

この例はメモ欄に"awesome provider"の文字列があるプロバイダーをすべて取得します。

[GET] /v2/providers?where=notes = 'awesome provider'
    

Backlot は次のようなフィードを生成します。

{
 "items": [   {
   "package_id": "7370e1f93aa24f5aafafc1abb6418b55",
   "name": "This is an awesome provider.",
   "pcode": "pzd3M6WH2DENHKruXzs4nGI52AaY",
   "address": {
    "city": "London",
    "zip": "W11 2BQ",
    "country": "England",
    "street": "221B Baker St."
   },
   "created_at": "2012-02-08T19:52:28+00:00",
   "bucket": "http://uploader.ooyala.com",
   "admin_user_email": null,
   "notes": null,
   "phone_numbers": {
    "phone": "44-20-1234-5678"
   },
   "processing_profile_id": "81165e8d535c4f678784280218b26bff",
   "secret": "RSr3ZSmAG8Y0HW6PfNaiR4hxgadmQxrAwhlZONul",
   "status": "live"
  }  ]
}
    

この記事はお役にたちましたか?