- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- NewEnrichment Item
- غنی سازی متن
- غنی سازی مکان
- محل
- LatLng
- Map Enrichment
- آیتم غنی سازی
- آن را امتحان کنید!
غنی سازی را در یک موقعیت مشخص در یک آلبوم تعریف شده اضافه می کند.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
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
NewEnrichment Item
یک مورد غنیسازی جدید برای افزودن به آلبوم، که توسط albums.addEnrichment
استفاده میشود.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
enrichment میدان اتحادیه غنی سازی به آلبوم اضافه شود. این می تواند یک متن، مکان یا یک نقشه باشد. enrichment تنها می تواند یکی از موارد زیر باشد: | |
textEnrichment | متن برای اضافه شدن به آلبوم |
locationEnrichment | مکان به آلبوم اضافه شود. |
mapEnrichment | نقشه به آلبوم اضافه شود. |
غنی سازی متن
غنی سازی حاوی متن
نمایندگی JSON |
---|
{ "text": string } |
زمینه های | |
---|---|
text | متن برای این آیتم غنیسازی. |
غنی سازی مکان
غنی سازی حاوی یک مکان واحد.
نمایندگی 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] باشد. |
Map Enrichment
غنیسازی حاوی نقشه، نشاندهنده مکانهای مبدا و مقصد.
نمایندگی JSON |
---|
{ "origin": { object ( |
زمینه های | |
---|---|
origin | محل مبدا برای این مورد غنی سازی. |
destination | مکان مقصد برای این آیتم غنی شده. |
آیتم غنی سازی
یک مورد غنی سازی
نمایندگی JSON |
---|
{ "id": string } |
زمینه های | |
---|---|
id | شناسه کالای غنی شده |