تحميل وسائط

يمكنك استخدام Google My Business API لتحميل الوسائط باستخدام الطريقتَين التاليتَين:

• التحميل من عنوان URL
• التحميل من البايتات

التحميل من عنوان URL

لتحميل الصور من عنوان URL، أجرِ المكالمة التالية إلى Media.Create. استخدِم الفئة ذات الصلة حسب الحاجة.

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "PHOTO",
  "locationAssociation": {
    "category": "COVER"
  },
  "sourceUrl": “http://example.com/biz/image.jpg",
}

لتحميل فيديوهات من عنوان URL باستخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، يمكنك إجراء الطلب التالي إلى Media.Create:

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "VIDEO",
  "locationAssociation": {
    "category": "ADDITIONAL"
  },
  "sourceUrl": “http://example.com/biz/video.mp4",
}

التحميل من عدد البايتات

لتحميل الوسائط من وحدات البايت باستخدام Google My Business API، أكمِل الخطوات التالية:

ملاحظة: لا يمكن تحميل الوسائط من وحدات البايت إلا للمواقع الجغرافية. لتضمين الوسائط في المشاركة المحلية، عليك تحميلها من عنوان URL.

1. لبدء عملية التحميل، يُرجى إجراء المكالمة التالية:

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media:startUpload
     

   يعرض الردّ من واجهة برمجة التطبيقات نصًا يحتوي على MediaItemDataRef:

     {
     "resourceName": "GoogleProvidedValue",
     }

2. لتحميل البايتات، استخدِم القيمة resourceName التي تم إرجاعها من المكالمة التي تم إجراؤها في الخطوة السابقة. في ما يلي مثال على الوسائط التي سيتم تحميلها وهي صورة:

   curl -X POST -T ~/Downloads/pictureToUpload.jpg  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"

   في ما يلي مثال على محتوى الوسائط إذا كان فيديو:

   curl -X POST -T ~/Downloads/videoToUpload.mp4  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"

3. استخدِم resourceName الذي تم إرجاعه في الخطوة 1 للاتصال بالرقم Media.Create. استخدِم mediaFormat وcategory المناسبَين.

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
     {
       "mediaFormat": "PHOTO",
       "locationAssociation": {
         "category": "COVER"
       },
       "dataRef": {
         "resourceName": "GoogleProvidedValue"
       },
     }

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
     {
       "mediaFormat": "VIDEO",
       "locationAssociation": {
         "category": "ADDITIONAL"
       },
       "dataRef": {
         "resourceName": "GoogleProvidedValue"
       },
     }