অনুসন্ধান করুন এবং ফিল্টার প্রয়োগ করুন

প্রয়োজনীয় অনুমোদনের সুযোগ

Google Photos Library API-এ মিডিয়া আইটেম এবং অ্যালবাম অ্যাক্সেস করতে ব্যবহৃত একাধিক স্কোপ রয়েছে। বিভিন্ন কল থেকে প্রত্যাবর্তিত মিডিয়া আইটেমগুলি ভিন্ন যেগুলির উপর ভিত্তি করে বিকাশকারীর দ্বারা অনুরোধ করা হয়েছে৷

photoslibrary.readonly স্কোপ ব্যবহারকারীর লাইব্রেরির সমস্ত মিডিয়া আইটেম অ্যাক্সেসের অনুমতি দেয়৷ photoslibrary.readonly.appcreateddata স্কোপ শুধুমাত্র অ্যাপ দ্বারা তৈরি মিডিয়া আইটেমগুলিতে অ্যাক্সেসের অনুমতি দেয়৷ আরও তথ্যের জন্য, অনুমোদনের সুযোগগুলি দেখুন।

উপলব্ধ ফিল্টার

আপনি নির্দিষ্ট ধরণের মিডিয়ার জন্য ব্যবহারকারীর লাইব্রেরি অনুসন্ধান করতে পারেন। উদাহরণ স্বরূপ, আপনি একটি নির্দিষ্ট দিন থেকে শুধুমাত্র পশুদের জিনিসপত্র চাইতে পারেন, অথবা আপনি রসিদের ফটো বাদ দিতে চাইতে পারেন। আপনি একটি অ্যালবাম বা লাইব্রেরি তালিকায় ফিল্টার প্রয়োগ করে নির্দিষ্ট আইটেমগুলি বাদ দিতে বা অন্তর্ভুক্ত করতে পারেন৷ মিডিয়া আইটেম বৈশিষ্ট্যের উপর ভিত্তি করে পাঁচটি উপলব্ধ ফিল্টার রয়েছে:

যদি albumId সেট করা থাকে তাহলে mediaItems:search অনুরোধে ফিল্টার ব্যবহার করা উচিত নয়। অ্যালবামআইডি সেট করার সময় ফিল্টার ব্যবহার করা হলে, একটি 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": {
    ...
  }
}

POST অনুরোধ নিম্নলিখিত প্রতিক্রিয়া প্রদান করে:

{
  "mediaItems": [
    ...
  ],
  "nextPageToken": "token-for-pagination"
}

জাভা

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
}

পিএইচপি

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 ফটোতে সমতুল্য লেবেলের মতোই সঠিক। কিছু ক্ষেত্রে, আইটেমগুলিকে ভুল লেবেল করা হতে পারে, তাই আমরা বিষয়বস্তু বিভাগের ফিল্টারগুলির যথার্থতার গ্যারান্টি দিই না।

বিভাগ সহ

আপনি যখন একাধিক বিভাগ অন্তর্ভুক্ত করেন, তখন যেকোনও বিভাগের সাথে মেলে এমন মিডিয়া আইটেমগুলি অন্তর্ভুক্ত করা হয়। প্রতি অনুরোধে সর্বাধিক 10টি বিভাগ অন্তর্ভুক্ত করা যেতে পারে। এই উদাহরণ ফিল্টার LANDSCAPES বা LANDMARKS এর যেকোনো আইটেম প্রদান করে।

বিশ্রাম

{
  "filters": {
    "contentFilter": {
      "includedContentCategories": [
        "LANDSCAPES",
        "LANDMARKS"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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()]
);

বিভাগ বাদ দিয়ে

শুধুমাত্র মিডিয়া আইটেমগুলি দেখানো হয় যা বাদ দেওয়া বিভাগের সাথে মেলে না। অন্তর্ভুক্ত বিভাগগুলির মতো, প্রতি অনুরোধে সর্বাধিক 10টি বিভাগ বাদ দেওয়া যেতে পারে।

এই ফিল্টারটি এমন কোনো আইটেম ফেরত দেয় যা PEOPLE বা SELFIES নয়:

বিশ্রাম

{
  "filters": {
    "contentFilter": {
      "excludedContentCategories": [
        "PEOPLE",
        "SELFIES"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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
        }
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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
          }
        }
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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
          }
        }
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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 ফটো অ্যাপ্লিকেশনে পছন্দসই হিসাবে চিহ্নিত করা হয়েছে৷

প্রিয়

শুধুমাত্র ব্যবহারকারীর পছন্দ হিসাবে চিহ্নিত মিডিয়া আইটেমগুলি ফেরাতে FeatureFilter FAVORITES আইটেম বৈশিষ্ট্যটি অন্তর্ভুক্ত করুন:

বিশ্রাম

{
  "filters" : {
    "featureFilter": {
      "includedFeatures": [
        "FAVORITES"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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 বিভিন্ন ইমেজ ফরম্যাটের যেকোনো একটি হতে পারে:

বিএমপি জেপিজি
জিআইএফ পিএনজি
HEIC টিআইএফএফ
আইসিও WEBP

এটিতে iOS লাইভ ফটো, মোশন ফটো, প্যানোরামা, 360 ডিগ্রি প্যানোরামা এবং ভিআর ফটোর মতো বিশেষ ধরনের ফটোও অন্তর্ভুক্ত রয়েছে।

ভিডিও

একটি VIDEO বিভিন্ন ভিডিও ফরম্যাট হতে পারে:

3GP এমএমভি
3G2 MOD
এএসএফ MOV
এভিআই MP4
ডিভিএক্স এমপিজি
M2T এমটিএস
M2TS TOD
M4V WMV
এমকেভি

VIDEO নিম্নলিখিতগুলির মতো বিশেষ ভিডিও ফর্ম্যাটগুলিও রয়েছে: ভিআর ভিডিও, স্লো-মোশন ভিডিও এবং Google ফটো অ্যাপ্লিকেশনে তৈরি অ্যানিমেশন৷

PHOTO দ্বারা নিম্নলিখিত উদাহরণ ফিল্টার:

বিশ্রাম

{
  "filters": {
    "mediaTypeFilter": {
      "mediaTypes": [
        "PHOTO"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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()]
);

একাধিক মিডিয়া ধরনের ফিল্টার একত্রিত করা যাবে না।

নন-অ্যাপ তৈরি ডেটা বাদ দিন

আপনার অ্যাপ দ্বারা তৈরি করা হয়নি এমন মিডিয়া আইটেমগুলি বাদ দিতে, আপনি নিম্নলিখিত উদাহরণে দেখানো হিসাবে excludeNonAppCreatedData ফিল্টার সেট করতে পারেন:

বিশ্রাম

{
  "filters": {
    "excludeNonAppCreatedData": true
  }
}

জাভা

// Create a new Filters object that excludes media not created by your app
Filters filters = Filters.newBuilder()
    .setExcludeNonAppCreatedData(true)
    .build();

// Specify the Filters object in the searchMediaItems call
SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);

পিএইচপি

// Create a new Filters object that excludes media not created by your app
$filtersBuilder = new FiltersBuilder();
$filtersBuilder->setExcludeNonAppCreatedData(true);

// Make a search call with the options set in the filters builder
$response = $photosLibraryClient->searchMediaItems(
    ['filters' => $filtersBuilder->build()]
);

মনে রাখবেন আপনি যদি .readonly.appcreateddata স্কোপ ব্যবহার করেন, তাহলে এই ফিল্টারটি উপেক্ষা করা হবে।

আর্কাইভ করা অবস্থা

আপনার ব্যবহারকারীরা তাদের কিছু ফটো আর্কাইভ করে থাকতে পারে। ডিফল্টরূপে, আর্কাইভ করা ফটোগুলি অনুসন্ধানে ফেরত দেওয়া হয় না৷ সংরক্ষণাগারভুক্ত আইটেমগুলি অন্তর্ভুক্ত করতে, আপনি নিম্নলিখিত উদাহরণে দেখানো হিসাবে ফিল্টারে একটি পতাকা সেট করতে পারেন:

বিশ্রাম

{
  "filters": {
    "includeArchivedMedia": true
  }
}

জাভা

// 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);

পিএইচপি

// 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 হিসাবে শ্রেণীবদ্ধ করা হয়েছে এবং যেগুলি হয় 2014 বা 2010 থেকে:

বিশ্রাম

{
  "filters": {
    "contentFilter": {
      "includedContentCategories": [
        "SPORT"
      ]
    },
    "dateFilter": {
      "dates": [
        {
          "year": 2014
        },
        {
          "year": 2010
        }
      ]
    },
    "mediaTypeFilter": {
      "mediaTypes": [
        "PHOTO"
      ]
    }
  }
}

জাভা

// 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);

পিএইচপি

// 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 মিডিয়া আইটেমগুলিকে ঊর্ধ্বমুখী ক্রমে ফেরত দেয় (প্রথম প্রাচীনতম আইটেম)

নিম্নলিখিত উদাহরণটি 2017 থেকে সমস্ত মিডিয়া আইটেম ফেরত দেয়, সবচেয়ে পুরানোটি প্রথম এবং সর্বশেষতমটি দেখায়৷

বিশ্রাম

{
  "filters": {
    "dateFilter": {
      "dates": [
        {
          "year": 2017
        }
      ]
    }
  },
  "orderBy": "MediaMetadata.creation_time"
}

জাভা

// 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);

পিএইচপি

// 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
    ]
);