Attention : Nous allons bientôt modifier l'API en profondeur, ce qui va nécessiter un travail de migration. Veuillez vous informer régulièrement via notre page sur les prochaines versions et le planning d'abandon. Vous pouvez également vous inscrire à notre liste de diffusion.

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