Important : La version 4.7 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Importer du contenu multimédia

Vous pouvez utiliser les deux méthodes suivantes pour importer du contenu multimédia dans l'API Google My Business :

Importer à partir d'une URL

Pour importer des photos dans l'API Google My Business à l'aide d'une URL, appelez Media.Create avec le contenu ci-dessous. Utilisez la catégorie appropriée.

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

Pour utiliser une URL pour l'importation de vidéos, appelez Media.Create avec le contenu ci-dessous :

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

Importer à partir d'octets

Pour importer du contenu multimédia dans l'API Google My Business à partir d'octets, procédez comme suit :

  1. Pour lancer l'importation, effectuez l'appel suivant :

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

    La réponse de l'API renvoie un corps contenant une référence MediaItemDataRef :

      {
      "resourceName": "GoogleProvidedValue",
      }
  2. Utilisez le resourceName renvoyé par l'appel effectué à l'étape précédente pour importer les octets. Dans l'exemple ci-dessous, le contenu multimédia à importer est une photo :

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

    Voici un exemple si le contenu est une vidéo :

    curl -X POST -T ~/Downloads/videoToUpload.mp4  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"
  3. Appelez Media.Create à l'aide du resourceName renvoyé à l'étape 1. Utilisez les mediaFormat et category appropriés.

      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"
        },
      }