Zengin öğeler ekleyin

Zenginleştirmeler, uygulamanızın Google Fotoğraflar'daki bir albümdeki fotoğrafların yapısını ve sunumunu kontrol etmesine olanak tanır. Metin veya yer ek açıklamaları ve birlikte bir hikaye anlatan resimleri sıralayarak/gruplandırarak kullanıcıya ek bağlam bilgisi sunmanıza olanak tanır.

Gerekli yetkilendirme kapsamı

Uygulama tarafından oluşturulan albümlere zenginleştirmeler eklemek için photoslibrary.appendonly kapsamı gerekir. Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

Zenginleştirme türleri

Google Fotoğraflar, albümlerde metin, konum ve harita olmak üzere üç tür zenginleştirmeyi destekler.

Metin zenginleştirmeleri

Metin zenginleştirme, albüme not eklemek için eklenebilecek düz metin dizesidir.

Konum zenginleştirmeleri

Konum zenginleştirme, bir konuma not eklemek için eklenebilecek bir işaretçi ve yer adıdır.

Harita zenginleştirmeleri

Harita zenginleştirme, albüme eklenebilecek belirli bir başlangıç ve varış noktasına sahip bir haritadır.

Konumlar

Medya öğeleri ve albüm zenginleştirmeleri eklemek için albümün konumunu belirtin. Konum, medya öğeleri için isteğe bağlıdır ancak albüm zenginleştirme için belirtilmelidir.

Konum yalnızca medya öğesi oluştururken veya zenginleştirmeler eklerken belirtilebilir. Albümdeki mevcut medya öğeleri yeniden düzenlenemez. Bu nedenle, öğe eklenirken konumunu ayarlamak önemlidir.

Albümün başı

Albümün başına mutlak konumlandırma olarak bir medya/zenginleştirme öğesi eklenebilir.

Albümün sonu

Albümün sonuna mutlak yerleşim olarak bir medya/zenginleştirme öğesi eklenebilir.

Medya öğesine göre

Bir medya/zenginleştirme öğesi, albümdeki konumundan sonra başlayan bir medya öğesine göre eklenebilir.

Zenginleştirme öğesine göre

Bir medya/zenginleştirme öğesi, albümdeki konumundan sonra başlayan bir zenginleştirme öğesine göre eklenebilir.

Albüme zenginleştirme ekleme

Zenginleştirmeler tek tek eklenir ve albümdeki bir konuma eklenmelidir. Bir albüme zenginleştirme eklemek için albums.addEnrichment işlevini çağırın.

İstek başarılı olursa zenginleştirme öğesinin id değerini döndürür. Bu, medya öğelerini veya diğer zenginleştirmeleri konumlandırmak için kullanılabilir.

REST

Aşağıda bir POST isteği verilmiştir:

POST https://photoslibrary.googleapis.com/v1/albums/album-id:addEnrichment
Content-type: application/json
Authorization: Bearer oauth2-token
request-body

İstek metni, zenginleştirme öğesinden ve konumundan oluşur:

{
  "newEnrichmentItem": {
    enrichment-to-be-added
  },
  "albumPosition": {
    position-of-enrichment
}

Aşağıda örnek bir yanıt verilmiştir:

{
  "enrichmentItem": {
    "id": "enrichment-item-id",
  }
}

Desteklenen zenginleştirmeler

Metin zenginleştirmeleri

Metin zenginleştirmeleri, aşağıdaki örnekte gösterildiği gibi tek bir metin dizesi (en fazla 1.000 karakter) içerir:

REST

{
  "text": "Text to be shown"
}

Java

// Use the NewEnrichmentItemFactory helper to create a text enrichment item
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createTextEnrichment("text to be shown");

PHP

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("text to be shown");

Konum zenginleştirmeleri

Konum zenginleştirmeleri, rastgele bir konum adından ve enlem ile boylam konumundan oluşur. locationName 500 karakterle sınırlıdır.

REST

{
  "location": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a location enrichment
// with the name, latitude, and longitude of the location
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createLocationEnrichment("Australia", -21.197, 95.821);

PHP

// Create a new location object and set the name, latitude, and longitude of the location
$newLocation = new Location();
$newLocation->setLocationName("Australia");
$newLocation->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithLocation($newLocation);

Harita zenginleştirmeleri

Harita zenginleştirmeleri, her biri bir ad, enlem ve boylamdan oluşan iki konum gösterir. Konum zenginleştirmeye benzer şekilde, kaynaktaki locationName ve destination 500 karakterle sınırlıdır.

REST

{
  "origin": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  },
  "destination": {
    "locationName": "San Francisco",
    "latlng": {
      "latitude": "37.757",
      "longitude": "122.507"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a map enrichment item for
// an origin and a destination location
NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createMapEnrichment(
    "Australia", -21.197, 95.821, // origin
    "San Francisco", 37.757, 122.507 // destination
);

PHP

// Create two new location objects to create a map enrichment item
// for an origin and a destination location
$locationAustralia = new Location();
$locationAustralia->setLocationName("Australia");
$locationAustralia->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$locationSanFrancisco = new Location();
$locationSanFrancisco->setLocationName("San Francisco");
$locationSanFrancisco->setLatlng((new LatLng())->setLatitude(37.757)->setLongitude(122.507));

$newEnrichmentItem =
  PhotosLibraryResourceFactory::newEnrichmentItemWithMap($locationAustralia, $locationSanFrancisco);

Desteklenen konumlandırma

Albümün başlangıcı

FIRST_IN_ALBUM konumu, albümün başlangıcını ifade eder. Burada bulunan öğeler kullanıcıya önce gösterilir:

REST

{
  "position": "FIRST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::FIRST_IN_ALBUM);

Albümün sonu

LAST_IN_ALBUM konumu albümün sonunu belirtir. Burada bulunan öğeler kullanıcıya en son gösterilir.

REST

{
  "position": "LAST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::LAST_IN_ALBUM);

Medya öğesine göre

relativeMediaItem konumunu belirtmek, bir medya öğesine göre konumu ifade eder. Öğeler, belirtilen medya öğesinden sonra eklenir.

REST

{
  "position": "after-media-item",
  "relativeMediaItemId": "media-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterMediaItem($mediaItemId);

Zenginleştirme öğesine göre

relativeEnrichmentItemId belirtmek, bir zenginleştirme öğesine göre konumu ifade eder. Öğeler, belirtilen zenginleştirme öğesinden sonra eklenir.

REST

{
  "position": "after-enrichment-item",
  "relativeEnrichmentItemId": "enrichment-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterEnrichmentItem($enrichmentItemId);

Zenginleştirmeleri değiştirme

Şu anda zenginleştirmeleri değiştirmenin bir yolu yoktur. Ancak bir zenginleştirme oluşturulup albüme eklendikten sonra kullanıcı, Google Fotoğraflar uygulaması üzerinden zenginleştirmeleri değiştirebilir.