Shopify Admin API
  1. Product
Shopify Admin API
  • Customers
    • Customer Address
      • Retrieves a list of addresses for a customer
      • Creates a new address for a customer
      • Retrieves details for a single customer address
      • Updates an existing customer address
      • Removes an address from a customer’s address list
      • Performs bulk operations for multiple customer addresses
      • Sets the default address for a customer
    • CustomerSavedSearch
      • Retrieves a list of customer saved searches
      • Creates a customer saved search
      • Retrieves a count of all customer saved searches
      • Retrieves a single customer saved search
      • Updates a customer saved search
      • Deletes a customer saved search
      • Retrieves all customers returned by a customer saved search
    • Customer
      • Retrieves a list of customers
      • Creates a customer
      • Searches for customers that match a supplied query
      • Retrieves a single customer
      • Updates a customer
      • Deletes a customer
      • Creates an account activation URL for a customer
      • Sends an account invite to a customer
      • Retrieves a count of customers
      • Retrieves all orders that belong to a customer
  • Sales channels
    • Checkout
      • Creates a checkout
      • Completes a checkout
      • Retrieves a checkout
      • Modifies an existing checkout
      • Retrieves a list of shipping rates
    • CollectionListing
      • Retrieve collection listings that are published to your app
      • Retrieve product_ids that are published to a collection_id
      • Retrieve a specific collection listing that is published to your app
      • Create a collection listing to publish a collection to your app
      • Delete a collection listing to unpublish a collection from your app
    • Product ResourceFeedback
      • Create a new Product ResourceFeedback
      • Receive a list of all Product ResourceFeedbacks
    • MobilePlatformApplication
      • List all of the mobile platform applications associated with the app
      • Create a mobile platform application
      • Get a mobile platform application
      • Update a mobile platform application
      • Delete a mobile platform application
    • ProductListing
      • Retrieve product listings that are published to your app
      • Retrieve product_ids that are published to your app
      • Retrieve a count of products that are published to your app
      • Retrieve a specific product listing that is published to your app
      • Create a product listing to publish a product to your app
      • Delete a product listing to unpublish a product from your app
    • ResourceFeedback
      • Create a new ResourceFeedback
      • Receive a list of all ResourceFeedbacks
    • Payment
      • Creates a new payment
      • Retrieves a list of payments on a particular checkout
      • Retrieves a single payment
      • Counts the number of payments attempted on a checkout
  • Products
    • Collect
      • Adds a product to a custom collection
      • Retrieves a list of collects
      • Removes a product from a collection
      • Retrieves a specific collect by its ID
      • Retrieves a count of collects
    • Collection
      • Retrieves a single collection
      • Retrieve a list of products belonging to a collection
    • CustomCollection
      • Retrieves a list of custom collections
      • Creates a custom collection
      • Retrieves a count of custom collections
      • Retrieves a single custom collection
      • Updates an existing custom collection
      • Deletes a custom collection
    • Product
      • Retrieve a list of products
        GET
      • Create a new product
        POST
      • Retrieve a count of products
        GET
      • Retrieve a single product
        GET
      • Updates a product
        PUT
      • Delete a product
        DELETE
    • Product Image
      • Receive a list of all Product Images
      • Create a new Product Image
      • Receive a count of all Product Images
      • Receive a single Product Image
      • Modify an existing Product Image
      • Remove an existing Product Image
    • Product Variant
      • Retrieves a list of product variants
      • Create a new Product Variant
      • Receive a count of all Product Variants
      • Receive a single Product Variant
      • Modify an existing Product Variant
      • Remove an existing Product Variant
    • SmartCollection
      • Retrieves a list of smart collections
      • Creates a smart collection
      • Retrieves a count of smart collections
      • Retrieves a single smart collection
      • Updates an existing smart collection
      • Removes a smart collection
      • Updates the ordering type of products in a smart collection
  • Orders
    • Abandoned checkouts
      • Retrieves a list of abandoned checkouts
    • DraftOrder
      • Create a new DraftOrder
      • Retrieves a list of draft orders
      • Modify an existing DraftOrder
      • Receive a single DraftOrder
      • Remove an existing DraftOrder
      • Receive a count of all DraftOrders
      • Send an invoice
      • Complete a draft order
    • Order Risk
      • Creates an order risk for an order
      • Retrieves a list of all order risks for an order
      • Retrieves a single order risk by its ID
      • Updates an order risk
      • Deletes an order risk for an order
    • Transaction
      • Retrieves a list of transactions
      • Creates a transaction for an order
      • Retrieves a count of an order's transactions
      • Retrieves a specific transaction
    • Order
      • Retrieve a list of orders
      • Create an order
      • Retrieve a specific order
      • Update an order
      • Delete an order
      • Retrieve an order count
      • Close an order
      • Re-open a closed order
      • Cancel an order
    • Refund
      • Retrieves a list of refunds for an order
      • Creates a refund
      • Retrieves a specific refund
      • Calculates a refund
  • Access
    • AccessScope
      • Get a list of access scopes
    • StorefrontAccessToken
      • Creates a new StorefrontAccessToken
      • Retrieves a list of storefront access tokens that have been issued
      • Deletes an existing storefront access token
  • Billing
    • ApplicationCredit
      • Creates an application credit
      • Retrieves all application credits
      • Retrieves a single application credit
    • ApplicationCharge
      • Creates an application charge
      • Retrieves a list of application charges
      • Retrieves an application charge
    • UsageCharge
      • Creates a usage charge
      • Retrieves a list of usage charges
      • Retrieves a single charge
    • RecurringApplicationCharge
      • Creates a recurring application charge
      • Retrieves a list of recurring application charges
      • Retrieves a single charge
      • Cancels a recurring application charge
      • Updates the capped amount of a recurring application charge
  • Online store
    • Asset
      • Retrieves a single asset for a theme
      • Creates or updates an asset for a theme
      • Deletes an asset from a theme
    • Blog
      • Retrieve a list of all blogs
      • Create a new Blog
      • Receive a count of all Blogs
      • Receive a single Blog
      • Modify an existing Blog
      • Remove an existing Blog
    • Article
      • Retrieves a list of all articles from a blog
      • Creates an article for a blog
      • Retrieves a count of all articles from a blog
      • Receive a single Article
      • Updates an article
      • Deletes an article
      • Retrieves a list of all article authors
      • Retrieves a list of all article tags
      • Retrieves a list of all article tags from a specific blog
    • Redirect
      • Retrieves a list of URL redirects
      • Creates a redirect
      • Retrieves a count of URL redirects
      • Retrieves a single redirect
      • Updates an existing redirect
      • Deletes a redirect
    • Comment
      • Retrieves a list of comments
      • Creates a comment for an article
      • Retrieves a count of comments
      • Retrieves a single comment by its ID
      • Updates a comment of an article
      • Marks a comment as spam
      • Marks a comment as not spam
      • Approves a comment
      • Removes a comment
      • Restores a previously removed comment
    • ScriptTag
      • Retrieves a list of all script tags
      • Creates a new script tag
      • Retrieves a count of all script tags
      • Retrieves a single script tag
      • Updates a script tag
      • Deletes a script tag
    • Page
      • Retrieves a list of pages
      • Creates a page
      • Retrieves a page count
      • Retrieves a single page by its ID
      • Updates a page
      • Deletes a page
    • Theme
      • Retrieves a list of themes
      • Creates a theme
      • Retrieves a single theme by its ID
      • Modify an existing Theme
      • Remove an existing Theme
  • Shipping and fulfillment
    • CancellationRequest
      • Sends a cancellation request
      • Accepts a cancellation request
      • Rejects a cancellation request
    • CarrierService
      • Create a new CarrierService
      • Receive a list of all CarrierServices
      • Modify an existing CarrierService
      • Receive a single CarrierService
      • Remove an existing CarrierService
    • AssignedFulfillmentOrder
      • Retrieves a list of fulfillment orders on a shop for a specific app
    • FulfillmentEvent
      • Retrieves a list of fulfillment events for a specific fulfillment
      • Creates a fulfillment event
      • Retrieves a specific fulfillment event
      • Deletes a fulfillment event
    • Fulfillment
      • Retrieves fulfillments associated with an order
      • Retrieves fulfillments associated with a fulfillment order
      • Retrieves a count of fulfillments associated with a specific order
      • Receive a single Fulfillment
      • Creates a fulfillment for one or many fulfillment orders
      • Updates the tracking information for a fulfillment
      • Cancels a fulfillment
    • FulfillmentOrder
      • Retrieves a list of fulfillment orders for a specific order
      • Retrieves a specific fulfillment order
      • Cancel a fulfillment order
      • Marks a fulfillment order as incomplete
      • Moves a fulfillment order to a new location
      • Marks the fulfillment order as open
      • Reschedules the fulfill_at time of a scheduled fulfillment order
      • Applies a fulfillment hold on an open fulfillment order
      • Sets deadline for fulfillment orders
      • Releases the fulfillment hold on a fulfillment order
    • LocationsForMove
      • Retrieves a list of locations that a fulfillment order can potentially move to.
    • FulfillmentRequest
      • Sends a fulfillment request
      • Accepts a fulfillment request
      • Rejects a fulfillment request
    • FulfillmentService
      • Receive a list of all FulfillmentServices
      • Create a new FulfillmentService
      • Receive a single FulfillmentService
      • Modify an existing FulfillmentService
      • Remove an existing FulfillmentService
  • Shopify Payments
    • Balance
      • Return the current balance
    • Dispute
      • Return a list of all disputes
      • Return a single dispute
    • Payouts
      • Return a list of all payouts
      • Return a single payout
    • Transactions
      • Return a list of all balance transactions
  • Analytics
    • Report
      • Retrieves a list of reports
      • Creates a new report
      • Retrieves a single report
      • Updates a report
      • Deletes a report
  • Deprecated API calls
    • Deprecated API calls
      • Retrieves a list of deprecated API calls
  • Discounts
    • DiscountCode
      • Creates a discount code
      • Retrieves a list of discount codes
      • Updates an existing discount code
      • Retrieves a single discount code
      • Deletes a discount code
      • Retrieves the location of a discount code
      • Retrieves a count of discount codes for a shop
      • Creates a discount code creation job
      • Retrieves a discount code creation job
      • Retrieves a list of discount codes for a discount code creation job
    • PriceRule
      • Creates a price rule
      • Retrieves a list of price rules
      • Updates an existing a price rule
      • Retrieves a single price rule
      • Remove an existing PriceRule
      • Retrieves a count of all price rules
  • Inventory
    • InventoryItem
      • Retrieves a detailed list for inventory items by IDs
      • Retrieves a single inventory item by ID
      • Updates an existing inventory item
    • Location
      • Retrieve a list of locations
      • Retrieve a single location by its ID
      • Retrieve a count of locations
      • Retrieve a list of inventory levels for a location
    • InventoryLevel
      • Retrieves a list of inventory levels
      • Deletes an inventory level from a location
      • Adjusts the inventory level of an inventory item at a location
      • Connects an inventory item to a location
      • Sets the inventory level for an inventory item at a location
  • Events
    • Event
      • Retrieves a list of events
      • Retrieves a single event
      • Retrieves a count of events
    • Webhook
      • Retrieves a list of webhooks
      • Create a new Webhook
      • Receive a count of all Webhooks
      • Receive a single Webhook
      • Modify an existing Webhook
      • Remove an existing Webhook
  • MarketingEvent
    • MarketingEvent
      • Retrieves a list of all marketing events
      • Creates a marketing event
      • Retrieves a count of all marketing events
      • Retrieves a single marketing event
      • Updates a marketing event
      • Deletes a marketing event
      • Creates marketing engagements on a marketing event
  • Metafield
    • Metafield
      • Retrieve a list of metafields from the resource's endpoint
      • Create a metafield
      • Retrieve a list of metafields by using query parameters
      • Retrieve a count of a resource's metafields.
      • Retrieve a specific metafield
      • Updates a metafield
      • Deletes a metafield by its ID
  • Plus
    • Gift Card
      • Retrieves a list of gift cards
      • Creates a gift card
      • Retrieves a single gift card
      • Updates an existing gift card
      • Retrieves a count of gift cards
      • Disables a gift card
      • Searches for gift cards
    • User
      • Retrieves a list of all users
      • Retrieves a single user
      • Retrieves the currently logged-in user
  • Store properties
    • Country
      • Receive a list of all Countries
      • Creates a country
      • Retrieves a count of countries
      • Retrieves a specific county
      • Updates an existing country
      • Remove an existing Country
    • Currency
      • Retrieves a list of currencies enabled on a shop
    • Policy
      • Retrieves a list of the shop's policies
    • ShippingZone
      • Receive a list of all ShippingZones
    • Province
      • Retrieves a list of provinces for a country
      • Retrieves a count of provinces for a country
      • Retrieves a single province for a country
      • Updates an existing province for a country
    • Shop
      • Retrieves the shop's configuration
  • TenderTransaction
    • TenderTransaction
      • Retrieves a list of tender transactions
  1. Product

Updates a product

PUT
/admin/api/{api_version}/products/{product_id}.json
Update a product

请求参数

Path 参数
api_version
string 
必需
product_id
string 
必需

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://demo.myshopify.com//admin/api//products/.json'

返回响应

🟢200Updates a product
application/json
Body
product
object (Product) 
可选
body_html
string 
可选
A description of the product. Supports HTML formatting.
created_at
string <ISO_8601>
只读可选
The date and time (ISO 8601 format) when the product was created.
handle
string 
可选
A unique human-friendly string for the product. Automatically generated from the product's title. Used by the Liquid templating language to refer to objects.
id
string <int64>
只读可选
An unsigned 64-bit integer that's used as a unique identifier for the product. Each id is unique across the Shopify system. No two products will have the same id, even if they're from different shops.
images
string 
可选
A list of product image objects, each one representing an image associated with the product.
示例值:
{"id":850703190,"product_id":632910392,"position":1,"created_at":"2018-01-08T12:34:47-05:00","updated_at":"2018-01-08T12:34:47-05:00","width":110,"height":140,"src":"http://example.com/burton.jpg","variant_ids":[{}]}
options
string 
可选
The custom product properties. For example, Size, Color, and Material. Each product can have up to 3 options and each option value can be up to 255 characters. Product variants are made of up combinations of option values.
Options cannot be created without values. To create new options, a variant with an associated option value also needs to be created.
product_type
string 
可选
A categorization for the product used for filtering and searching products.
published_at
string <ISO_8601>
可选
The date and time (ISO 8601 format) when the product was
published. Can be set to null to unpublish the product from the Online Store channel.
published_scope
string 
可选
Whether the product is published to the Point of Sale channel. Valid values:
  • web: The product isn't published to the Point of Sale channel.
  • global: The product is published to the Point of Sale channel.
status
string 
可选
The status of the product. Valid values:
  • active: The product is ready to sell and is available to customers on the online store, sales channels, and apps. By default, existing products are set to active.
  • archived: The product is no longer being sold and isn't available to customers on sales channels and apps.
  • draft: The product isn't ready to sell and is unavailable to customers on sales channels and apps. By default, duplicated and unarchived products are set to draft.
tags
string 
可选
A string of comma-separated tags that are used for filtering and search.
A product can have up to 250 tags. Each tag can have up to 255 characters.
template_suffix
string 
可选
The suffix of the Liquid template used for the product page. If this property is specified, then the product page uses a template called "product.suffix.liquid", where "suffix" is the value of this property. If this property is "" or null, then the product page uses the default template "product.liquid". (default: null)
title
string 
必需
The name of the product.
updated_at
string <ISO_8601>
只读可选
The date and time (ISO 8601 format) when the product was last modified.
A product's updated_at value can change for different reasons. For example, if an order is placed for a product that
has inventory tracking set up, then the inventory adjustment is counted as an update.
variants
string 
可选
An array of product variants, each representing a different version of the product.
The position property is read-only. The position of variants is indicated by the order in which they are listed.
示例值:
{"barcode":"1234_pink","compare_at_price":null,"created_at":"2012-08-24T14:01:47-04:00","fulfillment_service":"manual","grams":567,"weight":0.2,"weight_unit":"kg","id":808950810,"inventory_item_id":341629,"inventory_management":"shopify","inventory_policy":"continue","inventory_quantity":10,"option1":"Pink","position":1,"price":199.99,"product_id":632910392,"requires_shipping":true,"sku":"IPOD2008PINK","taxable":true,"title":"Pink","updated_at":"2012-08-24T14:01:47-04:00"}
vendor
string 
可选
The name of the product's vendor.
示例
{
  "product": {
    "id": 632910392,
    "title": "IPod Nano - 8GB",
    "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
    "vendor": "Apple",
    "product_type": "Cult Products",
    "created_at": "2023-01-03T12:56:35-05:00",
    "handle": "ipod-nano",
    "updated_at": "2023-01-03T12:59:19-05:00",
    "published_at": "2007-12-31T19:00:00-05:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "Emotive, Flash Memory, MP3, Music",
    "admin_graphql_api_id": "gid://shopify/Product/632910392",
    "variants": [
      {
        "id": 808950810,
        "product_id": 632910392,
        "title": "Pink",
        "price": "199.00",
        "sku": "IPOD2008PINK",
        "position": 1,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Pink",
        "option2": null,
        "option3": null,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "taxable": true,
        "barcode": "1234_pink",
        "grams": 567,
        "image_id": 562641783,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 808950810,
        "inventory_quantity": 10,
        "old_inventory_quantity": 10,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
      },
      {
        "id": 49148385,
        "product_id": 632910392,
        "title": "Red",
        "price": "199.00",
        "sku": "IPOD2008RED",
        "position": 2,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Red",
        "option2": null,
        "option3": null,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "taxable": true,
        "barcode": "1234_red",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 49148385,
        "inventory_quantity": 20,
        "old_inventory_quantity": 20,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
      },
      {
        "id": 39072856,
        "product_id": 632910392,
        "title": "Green",
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "position": 3,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Green",
        "option2": null,
        "option3": null,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "taxable": true,
        "barcode": "1234_green",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 39072856,
        "inventory_quantity": 30,
        "old_inventory_quantity": 30,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
      },
      {
        "id": 457924702,
        "product_id": 632910392,
        "title": "Black",
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "position": 4,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Black",
        "option2": null,
        "option3": null,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "taxable": true,
        "barcode": "1234_black",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 457924702,
        "inventory_quantity": 40,
        "old_inventory_quantity": 40,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
      }
    ],
    "options": [
      {
        "id": 594680422,
        "product_id": 632910392,
        "name": "Color",
        "position": 1,
        "values": [
          "Pink",
          "Red",
          "Green",
          "Black"
        ]
      }
    ],
    "images": [
      {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1672768595",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      {
        "id": 562641783,
        "product_id": 632910392,
        "position": 2,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1672768595",
        "variant_ids": [
          808950810
        ],
        "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
      },
      {
        "id": 378407906,
        "product_id": 632910392,
        "position": 3,
        "created_at": "2023-01-03T12:56:35-05:00",
        "updated_at": "2023-01-03T12:56:35-05:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1672768595",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/378407906"
      }
    ],
    "image": {
      "id": 850703190,
      "product_id": 632910392,
      "position": 1,
      "created_at": "2023-01-03T12:56:35-05:00",
      "updated_at": "2023-01-03T12:56:35-05:00",
      "alt": null,
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1672768595",
      "variant_ids": [],
      "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
    }
  }
}
修改于 2023-01-29 12:00:34
上一页
Retrieve a single product
下一页
Delete a product
Built with