- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- NewEnrichmentItem
- TextEnrichment
- LocationEnrichment
- מיקום
- LatLng
- MapEnrichment
- EnrichmentItem
- רוצים לנסות?
הוספת העשרה במיקום ספציפי באלבום מוגדר.
בקשת HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
albumId |
חובה. מזהה האלבום שאליו רוצים להוסיף את העשרה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "newEnrichmentItem": { object ( |
שדות | |
---|---|
newEnrichmentItem |
חובה. העשרה שצריך להוסיף. |
albumPosition |
חובה. המיקום באלבום שבו יש להוסיף את העשרה. |
גוף התשובה
פריט ההעשרה שנוצר.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"enrichmentItem": {
object ( |
שדות | |
---|---|
enrichmentItem |
פלט בלבד. העשרה שנוספה. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
NewEnrichmentItem
פריט העשרה חדש להוספה לאלבום, שישמש את הקריאה ל-albums.addEnrichment
.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד enrichment . העשרה שצריך להוסיף לאלבום. זה יכול להיות טקסט, מיקום או מפה. enrichment יכול להיות רק אחד מהבאים: |
|
textEnrichment |
הטקסט להוספה לאלבום. |
locationEnrichment |
המיקום שבו יתווסף לאלבום. |
mapEnrichment |
מפה להוספה לאלבום. |
TextEnrichment
העשרה שמכילה טקסט.
ייצוג JSON |
---|
{ "text": string } |
שדות | |
---|---|
text |
טקסט לפריט העשרה הזה. |
LocationEnrichment
העשרה שמכילה מיקום יחיד.
ייצוג JSON |
---|
{
"location": {
object ( |
שדות | |
---|---|
location |
המיקום של פריט ההעשרה הזה. |
מיקום
מייצג מיקום פיזי.
ייצוג JSON |
---|
{
"locationName": string,
"latlng": {
object ( |
שדות | |
---|---|
locationName |
שם המיקום שיוצג. |
latlng |
המיקום של המיקום במפה. |
LatLng
אובייקט שמייצג צמד של קו רוחב/אורך. מבוטא כצמד זוגות כדי לייצג מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, האובייקט חייב לעמוד ב תקן WGS84. הערכים חייבים להיות בטווחים מנורמלים.
ייצוג JSON |
---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. הערך צריך להיות בטווח של [ -90.0, +90.0]. |
longitude |
קו האורך במעלות. הערך צריך להיות בטווח של [ -180.0, +180.0]. |
MapEnrichment
העשרה שמכילה מפה שמציגה את מיקומי המוצא והיעד.
ייצוג JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
מיקום המוצא של פריט ההעשרה הזה. |
destination |
מיקום היעד של פריט ההעשרה הזה. |
EnrichmentItem
פריט העשרה.
ייצוג JSON |
---|
{ "id": string } |
שדות | |
---|---|
id |
מזהה של פריט ההעשרה. |