[SaaS만]{class="badge positive" title="Adobe Commerce as a Cloud Service 및 Adobe Commerce Optimizer 프로젝트에만 적용됩니다(Adobe 관리 SaaS 인프라)."}

제품에 파일 추가

Adobe Commerce as a Cloud Service은(는) 판매자가 PDF, 설명서, 인증서 및 데이터 시트와 같은 파일을 제품에 직접 첨부할 수 있도록 하는 "파일" 제품 특성 입력 유형을 지원합니다. 파일은 Amazon S3 미디어 저장소에 저장되며 GraphQL을 사용하는 상점 또는 REST API를 사용하는 통합을 통해 액세스할 수 있습니다.

파일을 제품 파일 속성에 업로드하는 방법에는 세 가지가 있습니다.

사전 요구 사항

파일을 업로드하기 전에 파일 속성을 만들고 속성 세트에 지정해야 합니다.

관리자를 통해 파일 업로드

파일 특성을 만들고특성 집합에 할당하면 제품 편집 페이지에서 직접 파일을 업로드할 수 있습니다.

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

파일을 바꾸려면 기존 파일을 삭제하고 새 파일을 업로드합니다. 업로드된 파일은 Amazon S3 미디어 저장소에 저장됩니다.

REST API를 통해 업로드

S3 사전 서명된 URL 흐름을 사용하여 REST API를 통해 프로그래밍 방식으로 파일을 업로드하십시오. 이 프로세스는 카테고리 이미지 및 고객 속성 파일과 같은 다른 미디어 유형의 제품 파일 속성과 동일한 방식으로 작동합니다.

이 프로세스에는 다음 네 가지 단계가 있습니다.

제품 가져오기를 통해 업로드

API 가져오기 또는 관리자 가져오기 UI를 사용하여 제품에 파일을 일괄적으로 첨부할 수 있습니다. 제품 파일 특성은 외부 URL에서만 가져오기를 지원하며, 이는 제품 이미지 가져오기에 대한 메서드 2와 동일한 접근 방식을 따릅니다. Commerce은 제공된 URL에서 파일을 다운로드하여 S3 미디어 저장소에 저장합니다.

전용 열에 URL 제공

속성 코드를 CSV 열 헤더로 사용하고 전체 URL을 값으로 사용합니다. 예를 들어 특성 코드가 file_upload이면 CSV는 다음과 같이 표시됩니다.

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

additional_attributes에 URL 제공

또는 additional_attributes 열에 파일 특성을 포함합니다.

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

두 경우 모두 URL을 공개적으로 액세스할 수 있어야 하며 파일 확장자와 크기는 구성된 제한 사항을 준수해야 합니다.

GraphQL을 통해 파일 검색

Adobe Commerce as a Cloud Service에서 카탈로그 서비스 GraphQL 끝점은 제품 데이터를 제공합니다. 파일 특성은 attributes의 ProductView 필드에 나타나며 value에는 파일에 대한 전체 공개 URL이 들어 있습니다.

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

응답에는 공용 URL에 파일 속성이 포함됩니다.

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

REST API를 통해 파일 검색

REST API(GET /V1/products/{sku})을(를) 통해 제품을 검색할 때 파일 특성이 파일 이름을 값으로 하여 custom_attributes 배열에 나타납니다.

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