প্রয়োজনীয় অনুমোদনের স্কোপ
photoslibrary.readonly স্কোপ ব্যবহারকারীর লাইব্রেরির সব মিডিয়া আইটেম অ্যাক্সেস করার অনুমতি দেয়।
অ্যাপের তৈরি করা কন্টেন্ট সার্চ ও ফিল্টার করতে
photoslibrary.readonly.appcreateddata স্কোপ প্রয়োজন। স্কোপ সম্পর্কে আরও তথ্যের জন্য,
অনুমোদনের স্কোপ দেখুন।
উপলভ্য ফিল্টার
আপনি নির্দিষ্ট ধরনের মিডিয়ার জন্য অ্যাপ-তৈরি মিডিয়া আইটেমের ব্যবহারকারীর লাইব্রেরি সার্চ করতে পারবেন। যেমন, আপনি হয়ত শুধু পশুদের ছবি, নির্দিষ্ট কোনও দিনের ছবি বা রসিদের ছবি বাদ দিয়ে বাকি ছবি দেখতে চান। আপনি অ্যালবাম বা লাইব্রেরি তালিকায় ফিল্টার প্রয়োগ করে নির্দিষ্ট আইটেম বাদ দিতে বা যোগ করতে পারবেন। মিডিয়া আইটেমের প্রপার্টির উপর ভিত্তি করে পাঁচটি ফিল্টার উপলভ্য আছে:
- কন্টেন্টের বিভাগ (
includedContentCategories,excludedContentCategories) - তারিখ ও তারিখের রেঞ্জ (
dates,ranges) - ফিচার (
featureFilter) - মিডিয়ার ধরন (
mediaTypeFilter) - আর্কাইভ করা স্ট্যাটাস (
includeArchivedMedia)
albumId সেট করা থাকলে, mediaItems.search অনুরোধে ফিল্টার ব্যবহার করা উচিত নয়। albumId সেট করার সময় ফিল্টার ব্যবহার করা হলে, INVALID_ARGUMENT সমস্যা
(400) দেখা যায়।
মিডিয়া আইটেম তৈরি করার সময় অনুযায়ী ফলাফল সাজানো হয়। তারিখ ফিল্টার ব্যবহার করে কোয়েরির জন্য ক্রমানুসারে সাজানোর সেটিং পরিবর্তন করা যেতে পারে।
নতুন আপলোড করা মিডিয়া আপনার সার্চে দেখতে পাওয়ার জন্য কিছুটা সময় দিন। মিডিয়াটি ফিল্টার না করা সার্চে অবিলম্বে দেখা যায়।
ভবিষ্যতের তারিখ সহ মিডিয়া আইটেম ফিল্টার করা সার্চে দেখা যায় না। এগুলি ফিল্টার না করা সার্চ ও অ্যালবাম সার্চে দেখা যায়।
ফিল্টার প্রয়োগ করা
ফিল্টার প্রয়োগ করতে,
mediaItems.search কল করুন এবং
filter প্রপার্টি উল্লেখ করুন।
বিশ্রাম
এখানে একটি POST অনুরোধ দেওয়া হল:
POST https://photoslibrary.googleapis.com/v1/mediaItems:search Content-type: application/json Authorization: Bearer oauth2-token { "pageSize": "100", "filters": { ... } }
পোস্ট রিকোয়েস্ট নিম্নলিখিত উত্তর পাঠায়:
{
"mediaItems": [
...
],
"nextPageToken": "token-for-pagination"
}Java
try { // Create a new Filter object Filters filters = Filters.newBuilder() // .setContentFilter(...) // .setDateFilter(...) // ... .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters); for (MediaItem item : response.iterateAll()) { // ... } } catch (ApiException e) { // Handle error }
PHP
try { $filtersBuilder = new FiltersBuilder(); // $filtersBuilder->addIncludedCategory(...); // $filtersBuilder->addDate(...); // ... // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] ); foreach ($response->iterateAllElements() as $element) { // ... } } catch (\Google\ApiCore\ApiException $e) { // Handle error }
বিস্তারিত জানতে, লাইব্রেরি কন্টেন্ট, অ্যালবাম ও মিডিয়া আইটেমের তালিকা দেখুন।
কন্টেন্ট বিভাগ
সব মিডিয়া আইটেম প্রসেস করা হয়েছে এবং লেবেল অ্যাসাইন করা হয়েছে। আপনি নিম্নলিখিত যেকোনও বিভাগ অন্তর্ভুক্ত করতে বা বাদ দিতে পারবেন।
ANIMALS |
FASHION |
LANDMARKS |
RECEIPTS |
WEDDINGS |
ARTS |
FLOWERS |
LANDSCAPES |
SCREENSHOTS |
WHITEBOARDS |
BIRTHDAYS |
FOOD |
NIGHT |
SELFIES |
|
CITYSCAPES |
GARDENS |
PEOPLE |
SPORT |
|
CRAFTS |
HOLIDAYS |
PERFORMANCES |
TRAVEL |
|
DOCUMENTS |
HOUSES |
PETS |
UTILITY |
ইউটিলিটি ফটোতে বিভিন্ন ধরনের মিডিয়া থাকে। এই বিভাগে সাধারণত এমন আইটেম থাকে যা ব্যবহারকারী কোনও টাস্ক সম্পূর্ণ করার জন্য ক্যাপচার করেছেন এবং টাস্ক সম্পূর্ণ হওয়ার পরে তার আর প্রয়োজন নেই। এর মধ্যে ডকুমেন্ট, রসিদ, স্ক্রিনশট, স্টিকি নোট, মেনু ও অন্যান্য একই ধরনের মিডিয়া আইটেম অন্তর্ভুক্ত।
Google Photos-এ সমতুল্য লেবেলের মতোই বিভাগগুলি সঠিক। কখনও কখনও, আইটেম ভুলভাবে লেবেল করা হতে পারে, তাই আমরা কন্টেন্ট ক্যাটেগরি ফিল্টারের নির্ভুলতার গ্যারান্টি দিই না।
বিভাগ সহ
আপনি একাধিক বিভাগ অন্তর্ভুক্ত করলে, যেকোনও বিভাগের সাথে ম্যাচ করে এমন মিডিয়া আইটেম
অন্তর্ভুক্ত করা হয়। প্রতিটি অনুরোধে সর্বাধিক ১০টি বিভাগ অন্তর্ভুক্ত করা যেতে পারে।
এই উদাহরণ ফিল্টার LANDSCAPES বা LANDMARKS-এর যেকোনও আইটেম দেখায়।
বিশ্রাম
{
"filters": {
"contentFilter": {
"includedContentCategories": [
"LANDSCAPES",
"LANDMARKS"
]
}
}
}Java
// Create a content filter that includes landmarks and landscapes ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.LANDMARKS) .addIncludedContentCategories(ContentCategory.LANDSCAPES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that includes landmarks and landscapes $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedCategory(ContentCategory::LANDMARKS); $filtersBuilder->addIncludedCategory(ContentCategory::LANDSCAPES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
বিভাগ বাদ দিয়ে
শুধুমাত্র বাদ দেওয়া বিভাগের সাথে মেলে না এমন মিডিয়া আইটেম দেখানো হয়। অন্তর্ভুক্ত করা বিভাগের মতোই, প্রতিটি অনুরোধে সর্বাধিক ১০টি বিভাগ বাদ দেওয়া যেতে পারে।
এই ফিল্টার PEOPLE বা SELFIES নয় এমন যেকোনও আইটেম দেখায়:
বিশ্রাম
{
"filters": {
"contentFilter": {
"excludedContentCategories": [
"PEOPLE",
"SELFIES"
]
}
}
}Java
// Create a content filter that excludes people and selfies ContentFilter contentFilter = ContentFilter.newBuilder() .addExcludedContentCategories(ContentCategory.PEOPLE) .addExcludedContentCategories(ContentCategory.SELFIES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that excludes people and selfies $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addExcludedCategory(ContentCategory::PEOPLE); $filtersBuilder->addExcludedCategory(ContentCategory::SELFIES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
একাধিক বিভাগ অন্তর্ভুক্ত করা এবং বাদ দেওয়া
আপনি কিছু বিভাগ অন্তর্ভুক্ত করতে এবং অন্যান্য বিভাগ বাদ দিতে পারেন। নিম্নলিখিত উদাহরণটি
LANDSCAPES এবং LANDMARKS ফিরিয়ে দেয়, কিন্তু PEOPLE বা SELFIES আছে এমন
যেকোনও মিডিয়া আইটেম সরিয়ে দেয়:
বিশ্রাম
{
"filters": {
"contentFilter": {
"includedContentCategories": [
"LANDSCAPES",
"LANDMARKS"
],
"excludedContentCategories": [
"PEOPLE",
"SELFIES"
]
}
}
}Java
// Create a content filter that excludes people and selfies and includes landmarks and landscapes ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.LANDSCAPES) .addIncludedContentCategories(ContentCategory.LANDMARKS) .addExcludedContentCategories(ContentCategory.PEOPLE) .addExcludedContentCategories(ContentCategory.SELFIES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that excludes people and selfies and includes landmarks and landscapes $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedCategory(ContentCategory::LANDMARKS); $filtersBuilder->addIncludedCategory(ContentCategory::LANDSCAPES); $filtersBuilder->addExcludedCategory(ContentCategory::PEOPLE); $filtersBuilder->addExcludedCategory(ContentCategory::SELFIES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
তারিখ এবং তারিখের রেঞ্জ
তারিখ ফিল্টার, নির্দিষ্ট দিনের সেটের মধ্যে রিটার্ন করা ফলাফলের তারিখ সীমাবদ্ধ করে। তারিখের ফিল্টার নির্দিষ্ট করার দুটি উপায় আছে: তারিখ বা রেঞ্জ। তারিখ এবং রেঞ্জ একসাথে ব্যবহার করা যেতে পারে। তারিখ বা তারিখের রেঞ্জের সাথে মিলে যায় এমন মিডিয়া আইটেম ফেরত দেওয়া হয়। ঐচ্ছিকভাবে, ফলাফলের ক্রমানুসারে সাজানোর সেটিং পরিবর্তন করা যেতে পারে।
তারিখ
তারিখে বছর, মাস ও দিন থাকে। নিম্নলিখিত ফর্ম্যাটগুলি গ্রহণযোগ্য:
- বছর
- বছর, মাস
- বছর, মাস, দিন
- মাস, দিন
- মাসের
তারিখের কোনও অংশ খালি থাকলে বা শূন্য হিসেবে সেট করা থাকলে, সেটিকে ওয়াইল্ডকার্ড হিসেবে বিবেচনা করা হয়। যেমন, আপনি যদি দিন ও মাস সেট করেন, কিন্তু বছর সেট না করেন, তাহলে আপনি যেকোনও বছরের সেই দিন ও মাসের আইটেম অনুরোধ করছেন:
বিশ্রাম
{
"filters": {
"dateFilter": {
"dates": [
{
"month": 2,
"day": 15
}
]
}
}
}Java
// Create a new com.google.type.Date object using a builder // Note that there are different valid combinations as described above Date dayFebruary15 = Date.newBuilder() .setDay(15) .setMonth(2) .build(); // Create a new dateFilter. You can also set multiple dates here DateFilter dateFilter = DateFilter.newBuilder() .addDates(dayFebruary15) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Google\Type\Date object with a day and a month // Note that there are different valid combinations as described above $dateFebruary15 = new Date(); $dateFebruary15->setDay(15); $dateFebruary15->setMonth(2); $filtersBuilder = new FiltersBuilder(); // Add the date to the filter. You can also set multiple dates here $filtersBuilder->addDate($dateFebruary15); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
তারিখের রেঞ্জ
তারিখের রেঞ্জ তারিখের চেয়ে বেশি নমনীয়তা প্রদান করে। যেমন, একাধিক তারিখ যোগ করার পরিবর্তে, এক মাসের মধ্যে দিনের সেট দেখতে তারিখের রেঞ্জ ব্যবহার করা যেতে পারে।
তারিখের রেঞ্জে startDate এবং endDate থাকে, দুটিই সেট করতে হবে। রেঞ্জের প্রতিটি
তারিখের ফর্ম্যাট সংক্রান্ত সীমাবদ্ধতা তারিখ-এ
বর্ণনা করা ফর্ম্যাটের মতোই। তারিখগুলি অবশ্যই একই ফর্ম্যাটে হতে হবে: যদি শুরুর তারিখটি একটি
বছর এবং একটি মাস হয়, শেষ তারিখটিও অবশ্যই একটি বছর এবং একটি মাস হতে হবে। রেঞ্জগুলি
ইনক্লুসিভভাবে প্রয়োগ করা হয়, শুরু এবং শেষ তারিখগুলি প্রয়োগ করা ফিল্টারে অন্তর্ভুক্ত করা হয়:
বিশ্রাম
{
"filters": {
"dateFilter": {
"ranges": [
{
"startDate": {
"year": 2014,
"month": 6,
"day": 12
},
"endDate": {
"year": 2014,
"month": 7,
"day": 13
}
}
]
}
}
}Java
// Create new com.google.type.Date objects for two dates Date day2014June12 = Date.newBuilder() .setDay(12) .setMonth(6) .setYear(2014) .build(); Date day2014July13 = Date.newBuilder() .setDay(13) .setMonth(7) .setYear(2014) .build(); // Create a DateRange from these two dates DateRange dateRange = DateRange.newBuilder() .setStartDate(day2014June12) .setEndDate(day2014July13) .build(); // Create a new dateFilter with the date range. You can also set multiple date ranges here DateFilter dateFilter = DateFilter.newBuilder() .addRanges(dateRange) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create two new Google\Type\Date objects $date2014June12 = new Date(); $date2014June12->setDay(12); $date2014June12->setMonth(6); $date2014June12->setYear(2014); $date2014July13 = new Date(); $date2014July13->setDay(13); $date2014July13->setMonth(7); $date2014July13->setYear(2014); // Add the two dates as a date range to the filter // You can also set multiple date ranges here $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addDateRange($date2014June12, $date2014July13); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
তারিখ ও তারিখের রেঞ্জ একত্রিত করা
আপনি একই সময়ে একাধিক তারিখ ও একাধিক তারিখের রেঞ্জ ব্যবহার করতে পারবেন। এইসব তারিখের মধ্যে পড়ে এমন আইটেম ফলাফলে অন্তর্ভুক্ত করা হয়। আলাদা তারিখ এবং তারিখের রেঞ্জ একই ফর্ম্যাটে হতে হবে না, তবে প্রতিটি রেঞ্জের শুরু এবং শেষ তারিখ একই ফর্ম্যাটে হতে হবে:
বিশ্রাম
{
"filters": {
"dateFilter": {
"dates": [
{
"year": 2013
},
{
"year": 2011,
"month": 11
}
],
"ranges": [
{
"startDate": {
"month": 1
},
"endDate": {
"month": 3
}
},
{
"startDate": {
"month": 3,
"day": 24
},
"endDate": {
"month": 5,
"day": 2
}
}
]
}
}
}Java
// Create a new com.google.type.Date object for the year 2013 Date day2013 = Date.newBuilder() .setYear(2013) .build(); // Create a new com.google.type.Date object for November 2011 Date day2011November = Date.newBuilder() .setMonth(11) .setYear(2011) .build(); // Create a date range for January to March DateRange dateRangeJanuaryToMarch = DateRange.newBuilder() .setStartDate(Date.newBuilder().setMonth(1).build()) .setEndDate(Date.newBuilder().setMonth(3).build()) .build(); // Create a date range for March 24 to May 2 DateRange dateRangeMarch24toMay2 = DateRange.newBuilder() .setStartDate(Date.newBuilder().setMonth(3).setDay(24).build()) .setEndDate(Date.newBuilder().setMonth(5).setDay(2).build()) .build(); // Create a new dateFilter with the dates and date ranges DateFilter dateFilter = DateFilter.newBuilder() .addDates(day2013) .addDates(day2011November) .addRanges(dateRangeJanuaryToMarch) .addRanges(dateRangeMarch24toMay2) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Google\Type\Date object for the year 2013 $date2013 = new Date(); $date2013->setYear(2013); // Create a new Google\Type\Date object for November 2011 $dateNovember2011 = new Date(); $dateNovember2011->setMonth(11); $dateNovember2011->setYear(2011); $filtersBuilder = new FiltersBuilder(); // Create a date range for January to March $filtersBuilder->addDateRange((new Date())->setMonth(1), (new Date())->setMonth(3)); // Create a date range for March 24 to May 2 $filtersBuilder->addDateRange((new Date())->setMonth(3)->setDay(24), (new Date())->setMonth(5)->setDay(2)); $filtersBuilder->addDate($date2013); $filtersBuilder->addDate($dateNovember2011); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
মিডিয়া আইটেম ফিচার
ফিচার ফিল্টার, নির্দিষ্ট ফিচার আছে এমন আইটেমে ফলাফল সীমাবদ্ধ করে, যেমন Google Photos অ্যাপ্লিকেশনে পছন্দের হিসেবে চিহ্নিত করা হয়েছে।
পছন্দসই
FeatureFilter-এ
FAVORITES আইটেম
ফিচার অন্তর্ভুক্ত করুন
যাতে শুধুমাত্র ব্যবহারকারীর পছন্দের হিসেবে চিহ্নিত করা মিডিয়া আইটেমগুলি ফেরত দেওয়া যায়:
বিশ্রাম
{
"filters" : {
"featureFilter": {
"includedFeatures": [
"FAVORITES"
]
}
}
}Java
// Create a new FeatureFilter for favorite media items FeatureFilter featureFilter = FeatureFilter.newBuilder() .addIncludedFeatures(Feature.FAVORITES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setFeatureFilter(featureFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new FeatureFilter for favorite media items $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedFeature(Feature::FAVORITES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
মিডিয়ার ধরন
আপনি মিডিয়ার ধরন অনুযায়ী ফলাফল সীমিত করতে পারবেন: হয় ফটো অথবা ভিডিও।
ফটো
PHOTO-এর জন্য একাধিক ছবির ফর্ম্যাট ব্যবহার করা যেতে পারে:
| BMP | JPG |
| GIF | PNG |
| HEIC | TIFF |
| ICO | WEBP |
এছাড়াও, এতে iOS লাইভ ফটো, মোশন ফটো, প্যানোরামা, ফটো স্ফিয়ার ও VR ফটোর মতো বিশেষ ধরনের ফটো অন্তর্ভুক্ত।
ভিডিও
VIDEO-এর বিভিন্ন ভিডিও ফর্ম্যাট হতে পারে:
| 3GP | MMV |
| 3G2 | MOD |
| ASF | MOV |
| AVI | MP4 |
| DIVX | MPG |
| M2T | MTS |
| M2TS | TOD |
| M4V | WMV |
| MKV |
VIDEO-এ নিম্নলিখিত বিশেষ ভিডিও ফর্ম্যাটও অন্তর্ভুক্ত থাকে: VR ভিডিও,
স্লো-মোশন ভিডিও এবং Google Photos অ্যাপ্লিকেশনে তৈরি করা
অ্যানিমেশন।
নিম্নলিখিত উদাহরণ PHOTO অনুযায়ী ফিল্টার করে:
বিশ্রাম
{
"filters": {
"mediaTypeFilter": {
"mediaTypes": [
"PHOTO"
]
}
}
}Java
// Create a new MediaTypeFilter for Photo media items MediaTypeFilter mediaType = MediaTypeFilter.newBuilder() .addMediaTypes(MediaType.PHOTO) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setMediaTypeFilter(mediaType) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new MediaTypeFilter for Photo media items $filtersBuilder = new FiltersBuilder(); $filtersBuilder->setMediaType(MediaType::PHOTO); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
একাধিক মিডিয়া ধরনের ফিল্টার একসাথে যোগ করা যাবে না।
আর্কাইভ করা স্ট্যাটাস
আপনার ব্যবহারকারীরা তাদের কিছু ফটো আর্কাইভ করে থাকতে পারেন। ডিফল্ট হিসেবে, আর্কাইভ করা ফটো সার্চে দেখানো হয় না। আর্কাইভ করা আইটেম অন্তর্ভুক্ত করতে, আপনি ফিল্টারে একটি ফ্ল্যাগ সেট করতে পারেন যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
বিশ্রাম
{
"filters": {
"includeArchivedMedia": true
}
}Java
// Create a new Filters object that includes archived media Filters filters = Filters.newBuilder() .setIncludeArchivedMedia(true) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Filters object that includes archived media $filtersBuilder = new FiltersBuilder(); $filtersBuilder->setIncludeArchivedMedia(true); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ফিল্টার একত্রিত করা হচ্ছে
বিভিন্ন ধরনের ফিল্টার একসাথে ব্যবহার করা যেতে পারে। শুধুমাত্র সেইসব আইটেমই দেখানো হয় যেগুলি অনুরোধ করা সবকটি ফিচারের সাথে মিলে যায়।
ফিল্টার একত্রিত করার সময়, প্রতিটি ফিল্টারের ধরনের জন্য ফর্ম্যাটিং সংক্রান্ত বিধিনিষেধ
আলাদাভাবে ব্যবহার করার মতোই একই থাকে। নিচের উদাহরণে, শুধুমাত্র সেইসব ফটো
দেখানো হয়েছে যেগুলি SPORT হিসেবে শ্রেণীবদ্ধ করা হয়েছে এবং যেগুলি ২০১৪ বা ২০১০ সালের:
বিশ্রাম
{
"filters": {
"contentFilter": {
"includedContentCategories": [
"SPORT"
]
},
"dateFilter": {
"dates": [
{
"year": 2014
},
{
"year": 2010
}
]
},
"mediaTypeFilter": {
"mediaTypes": [
"PHOTO"
]
}
}
}Java
// Create a new ContentFilter that only includes SPORT items ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.SPORT) .build(); // Create a new media type filter that only includes PHOTO media items MediaTypeFilter mediaTypeFilter = MediaTypeFilter.newBuilder() .addMediaTypes(MediaType.PHOTO) .build(); // Create a new DateFilter that only includes items from 2010 or 2014 Date year2014 = Date.newBuilder().setYear(2014).build(); Date year2010 = Date.newBuilder().setYear(2010).build(); DateFilter dateFilter = DateFilter.newBuilder() .addDates(year2010) .addDates(year2014) .build(); // Create a new Filters object combining these filters Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .setMediaTypeFilter(mediaTypeFilter) .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new ContentFilter $filtersBuilder = new FiltersBuilder(); // Only include SPORT items $filtersBuilder->addIncludedCategory(ContentCategory::SPORT); // Only include PHOTO media items $filtersBuilder->setMediaType(MediaType::PHOTO); // Only include items from 2010 or 2014 $year2014 = new Date(); $year2014->setYear(2014); $year2010 = new Date(); $year2010->setYear(2010); $filtersBuilder->addDateRange($year2010, $year2014); // Make a search call with the options set in the filters builder // Filters have been combined in the filter builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ফলাফল সাজানো হচ্ছে
শুধুমাত্র তারিখ ফিল্টার ব্যবহার করা কোয়েরিগুলি সাজানো যেতে পারে।
আপনি যদি সাজানোর বিকল্প নির্দিষ্ট না করেন, তাহলে আপনার ফলাফল নিম্নক্রমে সাজানো হবে (সবচেয়ে নতুনটি প্রথমে)।
এই সারণীতে orderBy প্যারামিটারের জন্য কাজ করে এমন বিকল্পগুলি দেখানো হয়েছে:
orderBy প্যারামিটার |
|
|---|---|
MediaMetadata.creation_time desc |
মিডিয়া আইটেমগুলি বড় থেকে ছোট ক্রমে (সবচেয়ে নতুন আইটেম প্রথমে) দেখায় |
MediaMetadata.creation_time |
মিডিয়া আইটেম ঊর্ধ্বক্রমে দেখায় (সবচেয়ে পুরনো আইটেম প্রথমে) |
নিচের উদাহরণটি ২০১৭ সালের সব মিডিয়া আইটেম দেখায়, যেখানে সবচেয়ে পুরনোটি প্রথমে এবং সবচেয়ে নতুনটি শেষে দেখানো হয়।
বিশ্রাম
{
"filters": {
"dateFilter": {
"dates": [
{
"year": 2017
}
]
}
},
"orderBy": "MediaMetadata.creation_time"
}Java
// Create a new dateFilter for the year 2017. DateFilter dateFilter = DateFilter.newBuilder() .addDates(Date.newBuilder().setYear(2017)) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Sort results by oldest item first. final OrderBy newestFirstOrder = OrderBy.MEDIAMETADATA_CREATION_TIME; // Specify the filter and sort order in the searchMediaItems call. SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters, newestFirstOrder);
PHP
// Create a new dateFilter for the year 2017. $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addDate((new Date())->setYear(2017)); // Make a search call with the options set in the filters builder and sort // the results by oldest item first. $response = $photosLibraryClient->searchMediaItems( [ 'filters' => $filtersBuilder->build(), 'orderBy' => OrderBy::MEDIAMETADATA_CREATION_TIME ] );