المرجع: MediaItem
ملف وسائط واحد
تمثيل JSON | |
---|---|
{ "name": string, "mediaFormat": enum ( |
الحقول | ||
---|---|---|
name |
اسم المورد لعنصر الوسائط هذا. |
|
mediaFormat |
تمثّل هذه السمة تنسيق عنصر الوسائط هذا. يجب ضبطها عند إنشاء عنصر الوسائط، وأن تكون متاحة للقراءة فقط في جميع الطلبات الأخرى. لا يمكن تعديلها. |
|
locationAssociation |
مطلوب عند الاتصال برقم هذا الإجراء مطلوب عند إضافة وسائط جديدة إلى موقع جغرافي باستخدام |
|
googleUrl |
النتائج فقط. عنوان URL الذي تستضيفه Google لعنصر الوسائط هذا. عنوان URL هذا ليس ثابتًا لأنّه قد يتغيّر بمرور الوقت. بالنسبة إلى الفيديو، ستكون هذه الصورة معاينة مع رمز تشغيل مركّب. |
|
thumbnailUrl |
النتائج فقط. عنوان URL لصورة مصغّرة لعنصر الوسائط هذا، في حال توفّره. |
|
createTime |
النتائج فقط. وقت إنشاء عنصر الوسائط هذا طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
|
dimensions |
النتائج فقط. الأبعاد (العرض والارتفاع) بالبكسل. |
|
insights |
النتائج فقط. إحصاءات لعنصر الوسائط هذا. |
|
attribution |
النتائج فقط. معلومات تحديد المصدر لعناصر وسائط العملاء يجب عرض هذه الإسناد على النحو المقدَّم للمستخدمين، ويجب عدم حذف الإسناد أو تغييره. |
|
description |
وصف عنصر الوسائط هذا. ولا يمكن تعديل الأوصاف من خلال واجهة برمجة تطبيقات "نشاطي التجاري على Google"، ولكن يمكن ضبطها عند إنشاء عنصر وسائط جديد ليس صورة غلاف. |
|
حقل الاتحاد باستثناء الفئتَين يجب أن تتوافق جميع الصور المحمَّلة مع إرشادات "الملف التجاري على Google" للصور. يمكن أن تكون السمة " |
||
sourceUrl |
عنوان URL متاح للجميع ويمكن استرداد عنصر الوسائط منه. عند إنشاء عنصر من هذه السمة أو dataRef، يجب ضبطهما لتحديد مصدر عنصر الوسائط. إذا تم استخدام لا يمكن تعديل هذا الحقل. |
|
dataRef |
الإدخال فقط. مرجع إلى البيانات الثنائية لعنصر الوسائط وفقًا لما تم الحصول عليه باستخدام طريقة عند إنشاء عنصر وسائط، يجب إما
أو
يجب تعيينها. |
MediaItemDataRef
مرجع إلى البيانات الثنائية للصور في MediaItem
التي تم تحميلها من خلال Google My Business API
يمكنك إنشاء مرجع بيانات باستخدام media.startUpload
، واستخدام هذا المرجع عند تحميل وحدات بايت إلى [media.upload] ثم طلب media.create
.
تمثيل JSON | |
---|---|
{ "resourceName": string } |
الحقول | |
---|---|
resourceName |
المعرّف الفريد للبيانات الثنائية لعنصر الوسائط هذا. تُستخدَم هذه الوظيفة لتحميل بيانات الصور باستخدام [media.upload] وعند إنشاء عنصر وسائط جديد من وحدات البايت هذه باستخدام مثال على تحميل وحدات البايت: بالنسبة إلى مكالمات |
MediaFormat
يشير حقل Enum إلى تنسيق الوسائط.
عمليات التعداد | |
---|---|
MEDIA_FORMAT_UNSPECIFIED |
لم يتم تحديد التنسيق. |
PHOTO |
عنصر الوسائط عبارة عن صورة. في هذا الإصدار، لا يتم دعم سوى الصور. |
VIDEO |
عنصر الوسائط هو فيديو. |
LocationAssociation
كيفية ارتباط عنصر الوسائط بموقعه الجغرافي
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد location_attachment_type يجب أن تحتوي وسائط المواقع الجغرافية على فئة أو رقم تعريف لعنصر قائمة الأسعار مرتبطان به. ويجب ألا تحتوي الوسائط التي لا تستند إلى الموقع الجغرافي (مثل صور المشاركات المحلية) على أي منهما. يمكن أن تكون السمة "location_attachment_type " واحدة فقط مما يلي: |
||
category |
الفئة التي تنتمي إليها صورة الموقع الجغرافي هذه. |
|
priceListItemId |
رقم تعريف عنصر قائمة الأسعار المرتبط بصورة الموقع الجغرافي هذه. |
الفئة
رقم تعداد فئة عنصر الوسائط.
عمليات التعداد | |
---|---|
CATEGORY_UNSPECIFIED |
فئة غير محدّدة. |
COVER |
صورة الغلاف. إذا كان للموقع الجغرافي صورة غلاف واحدة فقط |
PROFILE |
صورة الملف الشخصي. يحتوي الموقع الجغرافي على صورة ملف شخصي واحدة فقط. |
LOGO |
صورة الشعار |
EXTERIOR |
الوسائط الخارجية |
INTERIOR |
الوسائط الداخلية: |
PRODUCT |
وسائط المنتج |
AT_WORK |
وسائط "أثناء العمل" |
FOOD_AND_DRINK |
وسائط المأكولات والمشروبات |
MENU |
وسائط القائمة |
COMMON_AREA |
وسائط المنطقة المشتركة. |
ROOMS |
وسائط الغرف |
TEAMS |
وسائط Teams |
ADDITIONAL |
وسائط إضافية بلا فئة |
الأبعاد
أبعاد عنصر الوسائط.
تمثيل JSON | |
---|---|
{ "widthPixels": integer, "heightPixels": integer } |
الحقول | |
---|---|
widthPixels |
عرض عنصر الوسائط بالبكسل. |
heightPixels |
ارتفاع عنصر الوسائط بالبكسل. |
MediaInsights
إحصاءات وإحصاءات لعنصر الوسائط.
تمثيل JSON | |
---|---|
{ "viewCount": string } |
الحقول | |
---|---|
viewCount |
النتائج فقط. عدد مرات مشاهدة عنصر الوسائط. |
معلومات تحديد المصدر
معلومات تحديد المصدر لعناصر وسائط العملاء، مثل اسم المساهم وصورة ملفه الشخصي
تمثيل JSON | |
---|---|
{ "profileName": string, "profilePhotoUrl": string, "takedownUrl": string, "profileUrl": string } |
الحقول | |
---|---|
profileName |
اسم المستخدم الذي يرتبط به عنصر الوسائط. |
profilePhotoUrl |
عنوان URL للصورة المصغّرة لصورة الملف الشخصي للمستخدم الذي تم تحديد مصدره. |
takedownUrl |
عنوان URL لصفحة الإزالة التي يمكن من خلالها الإبلاغ عن عنصر الوسائط إذا كان غير ملائم |
profileUrl |
عنوان URL لصفحة الملف الشخصي للمستخدم الذي تم تحديد مصدره على "خرائط Google" |
الطُرق |
|
---|---|
|
ينشئ عنصر وسائط جديدًا للموقع الجغرافي. |
|
يؤدي هذا الإجراء إلى حذف عنصر الوسائط المحدّد. |
|
تعرض البيانات الوصفية لعنصر الوسائط المطلوب. |
|
تعرض قائمة بملفات الوسائط المرتبطة بموقع جغرافي. |
|
تعمل على تعديل البيانات الوصفية لعنصر الوسائط المحدَّد. |
|
يؤدي إلى إنشاء MediaItemDataRef لتحميل ملف الوسائط. |