- درخواست 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
-
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
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 | شناسه کالای غنی شده |