Method: albums.addEnrichment

הוספת העשרה במיקום ספציפי באלבום שנוצר על ידי אפליקציה.

בקשת HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
albumId

string

חובה. המזהה של האלבום שנוצר על ידי האפליקציה שאליו רוצים להוסיף את ההעשרה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
שדות
newEnrichmentItem

object (NewEnrichmentItem)

חובה. ההעשרה שרוצים להוסיף.
albumPosition

object (AlbumPosition)

חובה. המיקום באלבום שנוצר באפליקציה שבו רוצים להוסיף את ההעשרה.

גוף התשובה

פריט ההעשרה שנוצר.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
שדות
enrichmentItem

object (EnrichmentItem)

פלט בלבד. העשרה שנוספה.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

פריט העשרה חדש שנוסף לאלבום שנוצר על ידי האפליקציה, שמשמש את הקריאה albums.addEnrichment.

ייצוג ב-JSON 
{

  // Union field enrichment can be only one of the following:
  "textEnrichment": {
    object (TextEnrichment)
  },
  "locationEnrichment": {
    object (LocationEnrichment)
  },
  "mapEnrichment": {
    object (MapEnrichment)
  }
  // End of list of possible types for union field enrichment.
}
שדות
שדה האיחוד enrichment. הוספת תוכן לאלבום שנוצר באפליקציה. זה יכול להיות טקסט, מיקום או מפה. הערך של enrichment יכול להיות רק אחת מהאפשרויות הבאות:
textEnrichment

object (TextEnrichment)

הטקסט שיתווסף לאלבום שנוצר על ידי האפליקציה.
locationEnrichment

object (LocationEnrichment)

המיקום שיתווסף לאלבום שנוצר על ידי האפליקציה.
mapEnrichment

object (MapEnrichment)

המפה שרוצים להוסיף לאלבום שנוצר באפליקציה.

TextEnrichment

העשרה שמכילה טקסט.

ייצוג ב-JSON 
{
  "text": string
}
שדות
text

string

הטקסט של פריט ההעשרה הזה.

LocationEnrichment

העשרה שמכילה מיקום יחיד.

ייצוג ב-JSON 
{
  "location": {
    object (Location)
  }
}
שדות
location

object (Location)

המיקום של פריט ההעשרה הזה.

מיקום

מייצג מיקום פיזי.

ייצוג ב-JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
שדות
locationName

string

השם של המיקום שיוצג.
latlng

object (LatLng)

המיקום של המיקום במפה.

LatLng

אובייקט שמייצג צמד קואורדינטות של רוחב וקו אורך. הוא מופיע כצמד של מספרים שלמים (double) שמייצגים מעלות של קו רוחב ומעלות של קו אורך. אלא אם צוין אחרת, האובייקט הזה חייב לעמוד ב תקן WGS84. הערכים חייבים להיות בטווח נורמלי.

ייצוג ב-JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

MapEnrichment

העשרה שמכילה מפה שבה מוצגים מיקומי המקור והיעד.

ייצוג ב-JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
שדות
origin

object (Location)

מיקום המקור של פריט ההעשרה הזה.
destination

object (Location)

מיקום היעד של פריט ההעשרה הזה.

EnrichmentItem

פריט העשרה.

ייצוג ב-JSON 
{
  "id": string
}
שדות
id

string

המזהה של פריט ההעשרה.