REST Resource: accounts.locations.media

المرجع: MediaItem

ملف وسائط واحد

تمثيل JSON 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
الحقول
name

string

اسم المورد لعنصر الوسائط هذا. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

تمثّل هذه السمة تنسيق عنصر الوسائط هذا. يجب ضبطها عند إنشاء عنصر الوسائط، وأن تكون متاحة للقراءة فقط في جميع الطلبات الأخرى. لا يمكن تعديلها.
locationAssociation

object (LocationAssociation)

مطلوب عند الاتصال برقم CreatePhoto. يصف كيفية ارتباط عنصر الوسائط هذا بموقعه. يجب أن تكون فئة (على سبيل المثال، EXTERIOR) أو رقم تعريف لعنصر في قائمة الأسعار.

هذا الإجراء مطلوب عند إضافة وسائط جديدة إلى موقع جغرافي باستخدام media.create. وبالنسبة إلى أنواع الوسائط الأخرى، مثل الصور المنشورة في المشاركات المحلية، لن يتم عرض هذه البيانات.
googleUrl

string

النتائج فقط. عنوان URL الذي تستضيفه Google لعنصر الوسائط هذا. عنوان URL هذا ليس ثابتًا لأنّه قد يتغيّر بمرور الوقت. بالنسبة إلى الفيديو، ستكون هذه الصورة معاينة مع رمز تشغيل مركّب.
thumbnailUrl

string

النتائج فقط. عنوان URL لصورة مصغّرة لعنصر الوسائط هذا، في حال توفّره.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء عنصر الوسائط هذا

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
dimensions

object (Dimensions)

النتائج فقط. الأبعاد (العرض والارتفاع) بالبكسل.
insights

object (MediaInsights)

النتائج فقط. إحصاءات لعنصر الوسائط هذا.
attribution

object (Attribution)

النتائج فقط. معلومات تحديد المصدر لعناصر وسائط العملاء يجب عرض هذه الإسناد على النحو المقدَّم للمستخدمين، ويجب عدم حذف الإسناد أو تغييره.
description

string

وصف عنصر الوسائط هذا. ولا يمكن تعديل الأوصاف من خلال واجهة برمجة تطبيقات "نشاطي التجاري على Google"، ولكن يمكن ضبطها عند إنشاء عنصر وسائط جديد ليس صورة غلاف.

حقل الاتحاد data مصدر بيانات عنصر الوسائط. عند إنشاء عنصر وسائط جديد، يجب تقديم عنوان URL أو مرجع بيانات.

باستثناء الفئتَين PROFILE وCOVER، يجب أن يكون حجم جميع الصور لا يقل عن 250 بكسل على الحافة القصيرة، وأن يكون حجم الملف 10240 بايت على الأقل.

يجب أن تتوافق جميع الصور المحمَّلة مع إرشادات "الملف التجاري على Google" للصور. يمكن أن تكون السمة "data" واحدة فقط مما يلي:
sourceUrl

string

عنوان URL متاح للجميع ويمكن استرداد عنصر الوسائط منه.

عند إنشاء عنصر من هذه السمة أو dataRef، يجب ضبطهما لتحديد مصدر عنصر الوسائط.

إذا تم استخدام sourceUrl عند إنشاء عنصر وسائط، ستتم تعبئته بعنوان URL المصدر هذا عند استرداد عنصر الوسائط.

لا يمكن تعديل هذا الحقل.
dataRef

object (MediaItemDataRef)

الإدخال فقط. مرجع إلى البيانات الثنائية لعنصر الوسائط وفقًا لما تم الحصول عليه باستخدام طريقة media.startUpload.

عند إنشاء عنصر وسائط، يجب إما

sourceUrl

أو

dataRef

يجب تعيينها.

MediaItemDataRef

مرجع إلى البيانات الثنائية للصور في MediaItem التي تم تحميلها من خلال Google My Business API

يمكنك إنشاء مرجع بيانات باستخدام media.startUpload، واستخدام هذا المرجع عند تحميل وحدات بايت إلى [media.upload] ثم طلب media.create.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

المعرّف الفريد للبيانات الثنائية لعنصر الوسائط هذا. تُستخدَم هذه الوظيفة لتحميل بيانات الصور باستخدام [media.upload] وعند إنشاء عنصر وسائط جديد من وحدات البايت هذه باستخدام media.create.

مثال على تحميل وحدات البايت: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

بالنسبة إلى مكالمات media.create، يمكنك ضبط هذا الإعداد على أنّه MediaItem dataRef.

MediaFormat

يشير حقل Enum إلى تنسيق الوسائط.

عمليات التعداد
MEDIA_FORMAT_UNSPECIFIED لم يتم تحديد التنسيق.
PHOTO عنصر الوسائط عبارة عن صورة. في هذا الإصدار، لا يتم دعم سوى الصور.
VIDEO عنصر الوسائط هو فيديو.

LocationAssociation

كيفية ارتباط عنصر الوسائط بموقعه الجغرافي

تمثيل JSON 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
الحقول
حقل الاتحاد location_attachment_type يجب أن تحتوي وسائط المواقع الجغرافية على فئة أو رقم تعريف لعنصر قائمة الأسعار مرتبطان به. ويجب ألا تحتوي الوسائط التي لا تستند إلى الموقع الجغرافي (مثل صور المشاركات المحلية) على أي منهما. يمكن أن تكون السمة "location_attachment_type" واحدة فقط مما يلي:
category

enum (Category)

الفئة التي تنتمي إليها صورة الموقع الجغرافي هذه.
priceListItemId

string

رقم تعريف عنصر قائمة الأسعار المرتبط بصورة الموقع الجغرافي هذه.

الفئة

رقم تعداد فئة عنصر الوسائط.

عمليات التعداد
CATEGORY_UNSPECIFIED فئة غير محدّدة.
COVER صورة الغلاف. إذا كان للموقع الجغرافي صورة غلاف واحدة فقط
PROFILE صورة الملف الشخصي. يحتوي الموقع الجغرافي على صورة ملف شخصي واحدة فقط.
EXTERIOR الوسائط الخارجية
INTERIOR الوسائط الداخلية:
PRODUCT وسائط المنتج
AT_WORK وسائط "أثناء العمل"
FOOD_AND_DRINK وسائط المأكولات والمشروبات
MENU وسائط القائمة
COMMON_AREA وسائط المنطقة المشتركة.
ROOMS وسائط الغرف
TEAMS وسائط Teams
ADDITIONAL وسائط إضافية بلا فئة

الأبعاد

أبعاد عنصر الوسائط.

تمثيل JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
الحقول
widthPixels

integer

عرض عنصر الوسائط بالبكسل.
heightPixels

integer

ارتفاع عنصر الوسائط بالبكسل.

MediaInsights

إحصاءات وإحصاءات لعنصر الوسائط.

تمثيل JSON 
{
  "viewCount": string
}
الحقول
viewCount

string (int64 format)

النتائج فقط. عدد مرات مشاهدة عنصر الوسائط.

معلومات تحديد المصدر

معلومات تحديد المصدر لعناصر وسائط العملاء، مثل اسم المساهم وصورة ملفه الشخصي

تمثيل JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
الحقول
profileName

string

اسم المستخدم الذي يرتبط به عنصر الوسائط.
profilePhotoUrl

string

عنوان URL للصورة المصغّرة لصورة الملف الشخصي للمستخدم الذي تم تحديد مصدره.
takedownUrl

string

عنوان URL لصفحة الإزالة التي يمكن من خلالها الإبلاغ عن عنصر الوسائط إذا كان غير ملائم
profileUrl

string

عنوان URL لصفحة الملف الشخصي للمستخدم الذي تم تحديد مصدره على "خرائط Google"

الطُرق

create

 ينشئ عنصر وسائط جديدًا للموقع الجغرافي.

delete

 يؤدي هذا الإجراء إلى حذف عنصر الوسائط المحدّد.

get

 تعرض البيانات الوصفية لعنصر الوسائط المطلوب.

list

 تعرض قائمة بملفات الوسائط المرتبطة بموقع جغرافي.

patch

 تعمل على تعديل البيانات الوصفية لعنصر الوسائط المحدَّد.

startUpload

 يؤدي إلى إنشاء MediaItemDataRef لتحميل ملف الوسائط.