חיפוש והחלה של מסננים

היקפי ההרשאה הנדרשים

ההיקף photoslibrary.readonly מאפשר גישה לכל פריטי המדיה בספרייה של המשתמש.

כדי לחפש ולהחיל מסננים על תוכן שנוצר על ידי אפליקציה, נדרש ההיקף photoslibrary.readonly.appcreateddata. מידע נוסף על היקפים זמין במאמר היקפי הרשאה.

מסננים זמינים

אתם יכולים לחפש בספרייה של משתמש את סוגי המדיה הספציפיים שנוצרו באפליקציה. לדוגמה, יכול להיות שתרצו להציג רק תמונות של בעלי חיים מיום מסוים, או להחריג תמונות של קבלות. אתם יכולים להחריג או לכלול פריטים ספציפיים על ידי החלת מסננים על אלבום או על רשימה בספרייה. יש חמישה מסננים זמינים שמבוססים על מאפייני פריטי המדיה:

אי אפשר להשתמש במסננים בבקשת mediaItems.search אם albumId מוגדר. אם משתמשים במסנן כשמזהה האלבום מוגדר, מוחזרת השגיאה INVALID_ARGUMENT (400).

התוצאות ממוינות לפי זמן היצירה של פריט המדיה. אפשר לשנות את סדר המיון בשאילתות באמצעות מסנני תאריכים.

ייתכן שיחלוף זמן מה עד שתוכן מדיה חדש שהועלו יופיע בחיפושים שלכם. התוכן יופיע בחיפושים ללא סינון באופן מיידי.

פריטים של מדיה עם תאריך עתידי לא מופיעים בחיפושים מסוננים. הם מופיעים בחיפושים ללא סינון ובחיפושים באלבומים.

החלת מסנן

כדי להחיל מסנן, צריך להפעיל את הפונקציה mediaItems.search ולציין את המאפיין filter.

REST

זוהי בקשת 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"
}

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. לפעמים פריטים מסווגים בטעות, ולכן אנחנו לא מבטיחים את הדיוק של המסננים של קטגוריות התוכן.

כולל קטגוריות

כשמוסיפים כמה קטגוריות, פריטי המדיה שתואמים לאחת מהקטגוריות נכללים. אפשר לכלול עד 10 קטגוריות בכל בקשה. המסנן לדוגמה הזה מחזיר את כל הפריטים מסוג LANDSCAPES או LANDMARKS.

REST

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

החרגת קטגוריות

מוצגים רק פריטי מדיה שלא תואמים לאף אחת מהקטגוריות המוחרגות. בדומה לקטגוריות הכלולות, אפשר להחריג עד 10 קטגוריות לכל בקשה.

המסנן הזה מחזיר פריטים שאינם PEOPLE או SELFIES:

REST

{
  "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:

REST

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

תאריכים וטווחי תאריכים

מסנני תאריכים מגבילים את התאריך של התוצאות שמוחזרות לקבוצה מסוימת של ימים. יש שתי דרכים לציין מסנן תאריכים: תאריכים או טווחים. אפשר להשתמש בתאריכים ובטווחים יחד. יוחזרו פריטי מדיה שתואמים לאחד מהתאריכים או מטווחי התאריכים. אפשר גם לשנות את סדר המיון של התוצאות.

התאריכים

תאריך מכיל שנה, חודש ויום. הפורמטים הבאים קבילים:

  • שנה
  • שנה, חודש
  • שנה, חודש, יום
  • יום, חודש
  • חודש

אם רכיב כלשהו של התאריך ריק או מוגדר לאפס, הוא מטופל כתו כללי. לדוגמה, אם מגדירים את היום והחודש אבל לא את השנה, מבקשים פריטים מאותו יום וחודש בכל שנה:

REST

{
  "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, וצריך להגדיר את שניהם. לכל תאריך בטווח יש את אותם אילוצים של פורמט כפי שמתואר בקטע תאריכים. התאריכים חייבים להיות באותו פורמט: אם תאריך ההתחלה כולל שנה וחודש, גם תאריך הסיום צריך לכלול שנה וחודש. המערכת מחילה את הטווחים באופן כולל, ותאריכי ההתחלה והסיום כלולים במסנן שהוחל:

REST

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

שילוב של תאריכים וטווחי תאריכים

אפשר להשתמש בכמה תאריכים ובכמה טווחי תאריכים בו-זמנית. פריטים שנכללים באחד מהתאריכים האלה נכללים בתוצאות. התאריכים וטווחי התאריכים נפרדים לא חייבים להיות באותו פורמט, אבל תאריכי ההתחלה והסיום של טווחים מסוימים כן צריכים להיות:

REST

{
  "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.

מועדפים

כדי להציג רק פריטים של מדיה שהמשתמש סימן כפריטי מועדפים, צריך לכלול את מאפיין הפריט FAVORITES ב-FeatureFilter:

REST

{
  "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, תמונות עם תנועה, תמונות פנורמיות, תמונות ב-360° ותמונות VR.

וידאו

הערך של VIDEO יכול להיות פורמטים שונים של וידאו:

3GP MMV
3G2 מתמר
ASF ‎MOV.
‎.AVI MP4
DIVX MPG
M2T MTS
M2TS TOD
M4V WMV
MKV  

VIDEO כולל גם פורמטים מיוחדים של סרטונים, כמו סרטוני VR, סרטונים בהילוך איטי ואנימציות שנוצרו באפליקציית Google Photos.

בדוגמה הבאה מתבצע סינון לפי PHOTO:

REST

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

אי אפשר לשלב כמה מסננים של סוגי מדיה.

מצב בארכיון

יכול להיות שחלק מהמשתמשים העבירו לארכיון חלק מהתמונות שלהם. כברירת מחדל, תמונות בארכיון לא מופיעות בחיפושים. כדי לכלול פריטים בארכיון, אפשר להגדיר דגל במסנן, כפי שמתואר בדוגמה הבאה:

REST

{
  "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 והן משנת 2014 או 2010:

REST

{
  "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 החזרת פריטי מדיה בסדר עולה (הפריטים הישנים ביותר ראשונים)

בדוגמה הבאה מוצגים כל פריטי המדיה מ-2017, מהפריטים הישנים ביותר ועד לפריטים החדשים ביותר.

REST

{
  "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
    ]
);