बेहतर चीज़ें जोड़ें

एन्रिचमेंट की मदद से, ऐप्लिकेशन की स्ट्रक्चर और प्रज़ेंटेशन को कंट्रोल किया जा सकता है Google Photos में किसी एल्बम में मौजूद फ़ोटो. इनकी मदद से उपयोगकर्ता को प्रज़ेंट किया जा सकता है के साथ टेक्स्ट या स्थान एनोटेशन और आदेश/समूह के ज़रिए अतिरिक्त संदर्भ के साथ ऐसी इमेज जो साथ मिलकर कहानी बयां करती हों.

अनुमति के लिए ज़रूरी स्कोप

बेहतर बनाने के लिए, इनमें से कम से कम एक स्कोप ज़रूरी है:

• photoslibrary.appendonly
• photoslibrary.library
• photoslibrary.sharing

हर दायरे के लिए, enrichAlbum कॉल सिर्फ़ बनाए गए एल्बम तक सीमित होता है ऐप से.

.sharing स्कोप का इस्तेमाल करने पर, enrichAlbum सिर्फ़ कुछ परिस्थितियों में इस्तेमाल किया जा सकता है जहां डेवलपर, शेयर किए गए एल्बम के मालिक की ओर से कार्रवाई कर रहा है.

जानकारी के टाइप

Google Photos, एल्बम में तीन तरह की सुविधाओं का इस्तेमाल करता है: टेक्स्ट, और मैप को ऐक्सेस करने की सुविधा मिलती है.

टेक्स्ट को बेहतर बनाने की सुविधा

टेक्स्ट एनटाइटलमेंट एक सादा टेक्स्ट स्ट्रिंग होती है. इसे एल्बम.

जगह की जानकारी बेहतर बनाना

स्थान संवर्धन एक मार्कर और स्थान का नाम है जिसे सम्मिलित किया जा सकता है जोड़ें.

मैप को बेहतर बनाएं

मैप को बेहतर बनाना, एक खास शुरुआत की जगह और डेस्टिनेशन वाला मैप होता है जिसे एल्बम में सम्मिलित किया गया.

गड़बड़ी की जगह

मीडिया आइटम और एल्बम में बेहतर बनाने की सुविधा शामिल करने के लिए, एल्बम की स्थिति बताएं. मीडिया आइटम के लिए स्थिति वैकल्पिक है, लेकिन एल्बम के लिए दर्ज होनी चाहिए जानकारी.

स्थिति सिर्फ़ तब तय की जा सकती है, जब मीडिया आइटम बनाना या नई जानकारी जोड़ी जा सकती है. किसी एल्बम के मौजूदा मीडिया आइटम फिर से व्यवस्थित नहीं किए जा सकते. इसलिए जोड़े जाते समय आइटम की जगह सेट करना ज़रूरी है.

एल्बम की शुरुआत

मीडिया/बेहतर बनाए गए आइटम को एल्बम की शुरुआत में ऐब्सलूट के तौर पर जोड़ा जा सकता है पोज़िशनिंग.

एल्बम का आखिरी वीडियो

एल्बम के आखिर में, किसी मीडिया/बेहतर आइटम को ऐब्सलूट के तौर पर जोड़ा जा सकता है पोज़िशनिंग.

मीडिया आइटम के सापेक्ष

इसके बाद शुरू होने वाले मीडिया आइटम के लिए, मीडिया/बेहतर जानकारी वाला आइटम जोड़ा जा सकता है एल्बम में अपनी जगह कैसे बनाई.

बेहतर बनाए गए आइटम के बारे में

बेहतर बनाए गए आइटम की शुरुआत में किसी मीडिया/बेहतर बनाए गए आइटम को जोड़ा जा सकता है 20% कम खोजें.

एल्बम में नई चीज़ें जोड़ी जा रही हैं

एन्हैंसमेंट को एक-एक करके जोड़ा जाता है. साथ ही, उन्हें एल्बम में किसी पोज़िशन पर जोड़ा जाना चाहिए. किसी एल्बम में नई चीज़ें जोड़ने के लिए, इस पर कॉल करें albums.addEnrichment.

अनुरोध पूरा होने पर, यह बेहतर आइटम का id दिखाता है, जो का इस्तेमाल मीडिया आइटम या दूसरी चीज़ों को रखने के लिए किया जा सकता है.

आराम

यहां एक पोस्ट अनुरोध दिया गया है:

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

अनुरोध के मुख्य हिस्से में पेमेंट को बेहतर बनाने वाला आइटम और उसकी जगह की जानकारी शामिल होती है:

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

यहां जवाब का एक सैंपल दिया गया है:

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

Java

try {
  // Create the enrichment using the NewEnrichmentItemFactory helper
  NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createTextEnrichment("");

  // Set the position of the enrichment within the album
  AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

  // To add an enrichment, specify the album, the enrichment item,
  // and the position in the album where the enrichment is to be added
  AddEnrichmentToAlbumResponse response = photosLibraryClient
      .addEnrichmentToAlbum(albumId, newEnrichmentItem, albumPosition);
  // The response contains an EnrichmentItem
  // whose ID can be used to position media items or other enrichments
  EnrichmentItem enrichmentItem = response.getEnrichmentItem();
  String itemId = enrichmentItem.getId();
} catch (ApiException e) {
  // Handle error
}

PHP

// Create the enrichment item using the PhotosLibraryResourceFactory helper
$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("");
// ...
// Set the position of the enrichment within the album
$position = new AlbumPosition();
// ...
try {
    // To add an enrichment, specify the album, the enrichment item,
    // and the position in the album where the enrichment is to be added
    $response = $photosLibraryClient->addEnrichmentToAlbum($albumId, $newEnrichmentItem, $position);
    // The response contains an EnrichmentItem
    // whose ID can be used to position media items or other enrichments
    $enrichmentItem = $response->getEnrichmentItem();
    $itemId = $enrichmentItem->getId();

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

इस सुविधा का इस्तेमाल करने पर

टेक्स्ट को बेहतर बनाने की सुविधा

टेक्स्ट को बेहतर बनाने की सुविधा में एक टेक्स्ट स्ट्रिंग (1,000 से ज़्यादा वर्ण नहीं) होती है, जैसे कि नीचे दिए गए उदाहरण में दिखाया गया है:

आराम

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

जगह की जानकारी बेहतर बनाना

जगह की जानकारी में किसी जगह का आर्बिट्रेरी नाम और अक्षांश और देशांतर शामिल होते हैं देशांतर की पोज़िशन. locationName में ज़्यादा से ज़्यादा 500 वर्ण हो सकते हैं.

आराम

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

मैप को बेहतर बनाएं

मैप में दो जगहों की जानकारी जोड़ी जाती है, जिसमें नाम और अक्षांश शामिल होते हैं और देशांतर होता है. स्थान संवर्धन की तरह, locationName ऑरिजिन और destination में 500 से ज़्यादा वर्ण नहीं हो सकते.

आराम

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

इस्तेमाल की जा सकने वाली पोज़िशनिंग

एल्बम की शुरुआत

FIRST_IN_ALBUM स्थिति एल्बम के प्रारंभ के बारे में है. आइटम की जगह यहां सबसे पहले उपयोगकर्ता को दिखाए जाएंगे:

आराम

{
  "position": "FIRST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

PHP

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

एल्बम का आखिरी वीडियो

LAST_IN_ALBUM स्थिति एल्बम के अंत का संदर्भ देती है. यहां मौजूद आइटम उपयोगकर्ता को आखिरी बार दिखाए गए हों.

आराम

{
  "position": "LAST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

PHP

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

मीडिया आइटम के सापेक्ष

relativeMediaItem स्थिति तय करना, किसी मीडिया आइटम. आइटम, बताए गए मीडिया आइटम के बाद जोड़े जाते हैं.

आराम

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

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

PHP

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

बेहतर बनाए गए आइटम के बारे में

relativeEnrichmentItemId तय करने का मतलब है कि बेहतर बनाने वाला आइटम. चुने गए बेहतर आइटम के बाद आइटम जोड़े जाते हैं.

आराम

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

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

PHP

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

बेहतर बनाने की सुविधा में बदलाव करना

फ़िलहाल, बेहतर जानकारी में बदलाव करने का कोई तरीका नहीं है. हालांकि, एक बार एनहांसने के बाद को एक एल्बम में बनाया और जोड़ा जाता है, तो उपयोगकर्ता संवर्धनों को संशोधित कर सकता है से फ़ोटो और वीडियो देखें.