[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."}

Adicionar arquivos aos produtos

O Adobe Commerce as a Cloud Service oferece suporte ao tipo de entrada de atributo de produto do "Arquivo", que permite aos comerciantes anexar arquivos, como PDFs, manuais, certificados e folhas de dados, diretamente aos produtos. Os arquivos são armazenados no armazenamento de mídia do Amazon S3 e podem ser acessados por meio da loja usando o GraphQL ou por meio de integrações usando a REST API.

Há três maneiras de fazer upload de arquivos para atributos de arquivo de produto:

Pré-requisitos

Antes de fazer upload dos arquivos, você deve criar um atributo de arquivo e atribuí-lo a um conjunto de atributos.

Fazer upload de arquivos por meio do Administrador

Depois de criar um atributo de arquivo e atribuí-lo a um conjunto de atributos, você pode carregar arquivos diretamente da página de edição do produto.

{width="600" modal="regular"}

Para substituir um arquivo, exclua o arquivo existente e faça upload de um novo arquivo. O arquivo carregado é armazenado no armazenamento de mídia do Amazon S3.

Fazer upload por meio da API REST

Use o Fluxo de URL pré-assinado do S3 para carregar arquivos de forma programática por meio da API REST. Esse processo funciona para atributos de arquivo de produto da mesma maneira que para outros tipos de mídia, como imagens de categoria e arquivos de atributos do cliente.

O processo tem quatro etapas:

Upload por meio da importação do produto

Você pode anexar arquivos a produtos em massa usando a API de importação ou a interface de importação de administrador. Os atributos do arquivo de produto só oferecem suporte à importação de URLs externos, o que segue a mesma abordagem do Método 2 para importação de imagem de produto. O Commerce baixa o arquivo do URL fornecido e o salva no armazenamento de mídia S3.

Forneça o URL em uma coluna dedicada

Use o código do atributo como o cabeçalho da coluna CSV e o URL completo como o valor. Por exemplo, se o código do atributo for file_upload, o CSV terá esta aparência:

sku,name,file_upload
ADB112,"My Product",https://example.com/files/manual.pdf

Fornecer a URL em additional_attributes

Como alternativa, inclua o atributo de arquivo na coluna additional_attributes:

sku,name,additional_attributes
ADB112,"My Product",file_upload=https://example.com/files/manual.pdf

Em ambos os casos, a URL deve estar acessível publicamente e a extensão e o tamanho do arquivo devem estar em conformidade com as limitações configuradas.

Recuperar arquivos por meio do GraphQL

Em Adobe Commerce as a Cloud Service, o ponto de extremidade ​ do ​GraphQL do Serviço de Catálogo fornece dados do produto. Os atributos de arquivo aparecem no campo attributes em ProductView, com o value contendo a URL pública completa para o arquivo:

{
  products(skus: ["ADB112"]) {
    sku
    name
    attributes(roles: []) {
      name
      label
      value
    }
  }
}

A resposta inclui o atributo de arquivo com seu URL público:

{
  "data": {
    "products": [
      {
        "sku": "ADB112",
        "name": "Example product",
        "attributes": [
          {
            "name": "file",
            "label": "FILE",
            "value": "https://<host>/media/catalog/product_file/manual.pdf",
          }
        ]
      }
    ]
  }
}

Recuperar arquivos por meio da API REST

Ao recuperar um produto por meio da REST API (GET /V1/products/{sku}), os atributos de arquivo aparecem na matriz custom_attributes com o nome de arquivo como o valor:

{
  "custom_attributes": [
    {
      "attribute_code": "file_upload",
      "value": "manual_7aa0b2d63f6d3dbf.pdf"
    }
  ]
}