建立可下載的產品

最後更新： 2025年5月5日

建立對象：

  • 初學者
  • 開發人員
  • 使用者

瞭解如何使用REST API和Adobe Commerce管理員建立可下載的產品。

這部影片是給誰看的？

  • 網站管理員
  • 電子商務銷售商
  • 新的Adobe Commerce開發人員，瞭解如何使用REST API在Adobe Commerce中建立產品

視訊內容

允許下載的網域

您必須指定允許下載的網域。 網域會透過命令列新增到專案的env.php檔案。 env.php檔案詳細說明允許包含可下載內容的網域。 如果是在​ 之前，使用REST API ​建立可下載的產品，並更新php.env檔案，則會發生錯誤：

{
    "message": "Link URL's domain is not in list of downloadable_domains in env.php."
}

若要設定網域，請連線到伺服器： bin/magento downloadable:domains:add www.example.com

完成之後，就會在​ downloadable_domains ​陣列中修改env.php。

    'downloadable_domains' => [
        'www.example.com'
    ],

現在已將網域新增到env.php，您可以在Adobe Commerce管理員中或使用REST API建立可下載的產品。

請參閱組態參考以瞭解更多資訊。

IMPORTANT
在某些版本的Adobe Commerce上，當您在Adobe Commerce管理員中編輯產品時，可能會收到以下錯誤。 產品是使用REST API建立，但連結的下載專案價格為null。

Deprecated Functionality: number_format(): Passing null to parameter #1 ($num) of type float is deprecated in /app/vendor/magento/module-downloadable/Ui/DataProvider/Product/Form/Modifier/Data/Links.php on line 228。

若要修正此錯誤，請使用更新連結API： POST V1/products/{sku}/downloadable-links.

如需詳細資訊，請參閱使用cURL更新產品下載連結區段。

使用cURL建立可下載的產品（從遠端伺服器下載）

此範例說明當要下載的檔案不在相同伺服器上時，如何使用cURL建立可下載的產品。 如果檔案儲存在S3儲存貯體或其他數位資產管理器中，則此使用案例是典型行為。

curl --location '{{your.url.here}}/rest/default/V1/products' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Your Bearer Token}}' \
--header 'Cookie: PHPSESSID=b78cae2338f12d846d233d4e9486607e; private_content_version=564dde2976849891583a9a649073f01' \
--data '{
  "product": {
    "sku": "POSTMAN-download-product-1",
    "name": "POSTMAN download product-1",
    "attribute_set_id": 4,
    "price": 9.9,
    "status": 1,
    "visibility": 4,
    "type_id": "downloadable",
    "extension_attributes": {
        "website_ids": [
            1
        ],

        "downloadable_product_links": [
            {
                "title": "My url link",
                "sort_order": 1,
                "is_shareable": 1,
                "price": 0,
                "number_of_downloads": 0,
                "link_type": "url",
                "link_url": "{{location.url.where.file.exists}}/some-file.zip",
                "sample_type": "url",
                "sample_url": "{{location.url.where.file.exists}}/sample-file.zip"
            }
        ],
        "downloadable_product_samples": []
    },
    "product_links": [],
    "options": [],
    "media_gallery_entries": [],
    "tier_prices": []
  }
}
'