{"id":1811,"date":"2025-08-28T12:41:59","date_gmt":"2025-08-28T04:41:59","guid":{"rendered":"https:\/\/www.weswoo.com\/cn\/shopify-apikaifazhinangaoxiaodingzhidianshangpingtaidecelue\/"},"modified":"2026-10-04T21:17:25","modified_gmt":"2026-10-04T13:17:25","slug":"shopify-apikaifazhinangaoxiaodingzhidianshangpingtaidecelue","status":"publish","type":"post","link":"https:\/\/www.weswoo.com\/en\/shopify-apikaifazhinangaoxiaodingzhidianshangpingtaidecelue\/","title":{"rendered":"Shopify \u5546\u54c1\u67e5\u8be2\u9519\u641c\u6392\u67e5\uff1a\u7b5b\u9009\u5f0f\u8bca\u65ad\u4e0e\u66f4\u65b0\u65f6\u95f4\u8303\u56f4\u9a8c\u6536"},"content":{"rendered":"
\n

\u5546\u54c1\u67e5\u8be2\u8fd4\u56de\u4e86\u6570\u636e\uff0c\u5374\u5305\u542b\u8303\u56f4\u5916\u7684\u5546\u54c1\uff0c\u5148\u68c0\u67e5\u641c\u7d22\u5f0f\u662f\u5426\u88ab\u6309\u9884\u671f\u89e3\u6790\u3002\u672c\u6587\u9488\u5bf9 GraphQL Admin API \u7684 products<\/code> \u67e5\u8be2\uff0c\u5b8c\u6210\u4e00\u6b21\u201c\u8bca\u65ad\u641c\u7d22\u5f0f\u3001\u4fee\u6b63 UTC \u8fb9\u754c\u3001\u9a8c\u6536\u5c0f\u91cf\u7ed3\u679c\u201d\u7684\u53ea\u8bfb\u6392\u67e5\u3002\u8f93\u5165\u662f\u65f6\u95f4\u8303\u56f4\u548c\u5b9e\u9645\u8bf7\u6c42\uff1b\u8f93\u51fa\u662f\u53ef\u89e3\u91ca\u7684\u8bca\u65ad\u8bb0\u5f55\u4e0e\u6837\u672c\u7ed3\u679c\u3002<\/p>\n

\u672c\u6587\u6309 2026 \u5e74 10 \u6708 4 \u65e5\u6838\u5bf9\u7684 2026-10 \u6587\u6863\u7f16\u5199\u3002\u524d\u63d0\u662f\u73b0\u6709\u5e94\u7528\u5df2\u83b7\u5546\u5bb6\u6388\u6743\uff0c\u5e76\u5177\u6709\u6240\u9700\u7684 read_products<\/code> \u6743\u9650\uff1b\u4f7f\u7528\u5728\u7ebf\u8bbf\u95ee\u65b9\u5f0f\u65f6\u8fd8\u8981\u8003\u8651\u64cd\u4f5c\u7528\u6237\u7684\u6743\u9650\u3002\u5148\u786e\u8ba4\u73b0\u6709\u6388\u6743\uff0c\u518d\u6267\u884c\u4e0b\u9762\u7684\u8bfb\u53d6\u3002\u53c2\u89c1 Product \u6743\u9650\u8981\u6c42<\/a>\u548c\u8bbf\u95ee\u8303\u56f4\u4e0e\u5546\u5bb6\u6388\u6743\u8bf4\u660e<\/a>\u3002<\/p>\n

\u5148\u628a\u65f6\u95f4\u8303\u56f4\u5199\u6210\u53ef\u6838\u5bf9\u7684\u641c\u7d22\u5f0f<\/h2>\n

\u5047\u8bbe\u8981\u68c0\u67e5 UTC \u7684 2026 \u5e74 10 \u6708 1 \u65e5\uff0c\u7ea6\u5b9a\u8303\u56f4\u4e3a\u4e0b\u754c\u5305\u542b\u3001\u4e0a\u754c\u4e0d\u5305\u542b\uff0c\u5373\u4ece 2026-10-01T00:00:00Z<\/code> \u5230 2026-10-02T00:00:00Z<\/code>\u3002\u8fd9\u662f\u6f14\u793a\u8f93\u5165\uff0c\u4e0d\u4ee3\u8868\u67d0\u4e2a\u5546\u5e97\u7684\u5b9e\u9645\u6570\u636e\u3002\u5e26\u65f6\u533a\u7684\u8f93\u5165\u5e94\u5148\u8f6c\u6362\u4e3a UTC\uff0c\u4e0d\u80fd\u628a\u672c\u5730\u96f6\u70b9\u76f4\u63a5\u52a0\u4e0a Z<\/code>\u3002<\/p>\n

products<\/code> \u7684\u641c\u7d22\u5b57\u6bb5\u662f updated_at<\/code>\uff0c\u54cd\u5e94\u91cc\u7684\u5546\u54c1\u5b57\u6bb5\u5219\u662f updatedAt<\/code>\u3002\u641c\u7d22\u5f0f\u4e2d\u7684\u65e5\u671f\u503c\u8981\u52a0\u5f15\u53f7\uff0c\u4e24\u4e2a\u6bd4\u8f83\u6761\u4ef6\u4ee5\u7a7a\u683c\u8fde\u63a5\u3002\u6392\u5e8f\u91c7\u7528\u4e0e\u7b5b\u9009\u5b57\u6bb5\u76f8\u914d\u7684 UPDATED_AT<\/code>\uff1b\u9ed8\u8ba4\u6392\u5e8f\u952e\u662f ID<\/code>\u3002\u8fd9\u4e9b\u540d\u79f0\u5206\u522b\u89c1 products \u7684 updated_at \u4e0e sortKey \u5b9a\u4e49<\/a>\u3001ProductSortKeys<\/a>\u548c\u65e5\u671f\u6bd4\u8f83\u8bed\u6cd5<\/a>\u3002<\/p>\n

updated_at:>='2026-10-01T00:00:00Z' updated_at:<'2026-10-02T00:00:00Z'\n<\/code><\/pre>\n
\u5728\u5b9e\u9645\u8bf7\u6c42\u4e0a\u5f00\u542f\u641c\u7d22\u8bca\u65ad<\/h2>\n
\u5728\u73b0\u6709\u6388\u6743\u8bf7\u6c42\u5c42\u5411 \/admin\/api\/2026-10\/graphql.json<\/code> \u53d1\u9001\u4ee5\u4e0b\u67e5\u8be2\u548c\u53d8\u91cf\uff0c\u5e76\u52a0\u5165\u8bf7\u6c42\u5934 Shopify-Search-Query-Debug: 1<\/code>\u3002\u8fd9\u4e2a\u5934\u7528\u4e8e\u53d6\u5f97\u641c\u7d22\u8bca\u65ad\uff1b\u8981\u68c0\u67e5\u5b9e\u9645\u53d1\u9001\u7684\u5934\u548c\u53d8\u91cf\uff0c\u800c\u4e0d\u662f\u4ec5\u68c0\u67e5\u5ba2\u6237\u7aef\u7684\u914d\u7f6e\u5bf9\u8c61\u3002\u5b98\u65b9\u793a\u4f8b\u89c1\u641c\u7d22\u8bca\u65ad\u8bf7\u6c42\u5934\u4e0e\u54cd\u5e94<\/a>\u3002<\/p>\n
query ProductWindow($filter: String!, $after: String) {\n  products(first: 5, after: $after, query: $filter,\n           sortKey: UPDATED_AT, reverse: false) {\n    nodes { id updatedAt }\n    pageInfo { hasNextPage endCursor }\n  }\n}\n<\/code><\/pre>\n
{\n  "filter": "updated_at:>='2026-10-01T00:00:00Z' updated_at:<'2026-10-02T00:00:00Z'",\n  "after": null\n}\n<\/code><\/pre>\n
\u9996\u6b21\u8bf7\u6c42\u7684 after<\/code> \u4e3a null<\/code>\uff0cfirst: 5<\/code> \u53ea\u7528\u4e8e\u5c0f\u91cf\u68c0\u67e5\u3002\u8bb0\u5f55\u54cd\u5e94\u7684 X-Shopify-API-Version<\/code>\uff0c\u786e\u8ba4\u5b9e\u9645\u5904\u7406\u7248\u672c\u4e0e\u9884\u671f\u4e00\u81f4\uff1bShopify \u5bf9\u4e0d\u518d\u652f\u6301\u7684\u8bf7\u6c42\u7248\u672c\u53ef\u80fd\u56de\u9000\u5230\u53d7\u652f\u6301\u7248\u672c\uff0c\u4e0d\u80fd\u53ea\u770b URL\u3002\u53c2\u89c1\u7248\u672c\u54cd\u5e94\u5934\u8bf4\u660e<\/a>\u3002<\/p>\n
\u5148\u770b warnings\uff0c\u518d\u9010\u9879\u6838\u5bf9 parsed<\/h2>\n
\u5728\u54cd\u5e94\u7684 extensions.search<\/code> \u4e2d\u627e\u5230\u5bf9\u5e94 products<\/code> \u8def\u5f84\u7684\u8bb0\u5f55\uff0c\u5e76\u6838\u5bf9\u5176 query<\/code> \u4e0e\u672c\u6b21\u53d1\u9001\u7684\u7b5b\u9009\u5f0f\u3002\u968f\u540e\u68c0\u67e5 warnings<\/code> \u548c parsed<\/code>\u3002\u5b98\u65b9\u8bca\u65ad\u793a\u4f8b\u5305\u542b path<\/code>\u3001query<\/code>\u3001parsed<\/code>\u3001warnings<\/code>\uff1b\u65e0\u6548\u641c\u7d22\u5b57\u6bb5\u4f1a\u88ab\u5ffd\u7565\uff0c\u53ef\u80fd\u9020\u6210\u7ed3\u679c\u8303\u56f4\u6269\u5927\u3002\u5b57\u6bb5\u662f\u5426\u53ef\u7528\u5e94\u67e5\u5f53\u524d\u8d44\u6e90\u5b9a\u4e49\uff0c\u4e0d\u80fd\u5c06\u5176\u4ed6\u8d44\u6e90\u7684\u7b5b\u9009\u5b57\u6bb5\u76f4\u63a5\u642c\u6765\u3002\u53c2\u89c1\u641c\u7d22\u89e3\u6790\u4e0e\u65e0\u6548\u5b57\u6bb5\u8b66\u544a<\/a>\u3002<\/p>\n
    \n
  1. \u51fa\u73b0\u65e0\u6548\u5b57\u6bb5\u7b49\u8b66\u544a\u65f6\uff0c\u4fdd\u5b58\u539f\u8bf7\u6c42\u548c\u8b66\u544a\uff0c\u4fee\u6b63\u641c\u7d22\u5b57\u6bb5\u540e\u91cd\u65b0\u8bf7\u6c42\u3002\u6b64\u65f6\u8fd4\u56de\u4e86\u5546\u54c1\u4e5f\u4e0d\u80fd\u8bc1\u660e\u7b5b\u9009\u751f\u6548\u3002<\/li>\n
  2. \u6ca1\u6709\u8bca\u65ad\u8bb0\u5f55\u65f6\uff0c\u68c0\u67e5\u5b9e\u9645\u8bf7\u6c42\u662f\u5426\u643a\u5e26 debug \u5934\u3001\u54cd\u5e94\u6269\u5c55\u662f\u5426\u88ab\u4e2d\u95f4\u5c42\u4e22\u5f03\uff0c\u4ee5\u53ca\u8bf7\u6c42\u8def\u5f84\u548c\u53d8\u91cf\u662f\u5426\u5bf9\u5e94\u672c\u6b21\u67e5\u8be2\u3002<\/li>\n
  3. \u6709 parsed<\/code> \u4e14\u6ca1\u6709\u8fd4\u56de\u8b66\u544a\u540e\uff0c\u4ecd\u9700\u9605\u8bfb\u89e3\u6790\u7ed3\u679c\uff1a\u5b57\u6bb5\u5e94\u662f updated_at<\/code>\uff0c\u4e0b\u754c\u5e94\u5305\u542b\u3001\u4e0a\u754c\u5e94\u6392\u9664\uff0c\u4e24\u4e2a\u6761\u4ef6\u5e94\u5171\u540c\u7ea6\u675f\u8be5\u8303\u56f4\u3002<\/li>\n<\/ol>\n
    \u672c\u6587\u67e5\u8be2\u6ca1\u6709\u522b\u540d\uff0c\u56e0\u6b64\u4e0b\u9762\u7684\u8f85\u52a9\u51fd\u6570\u53ea\u5339\u914d\u8def\u5f84 [\"products\"]<\/code>\u3002\u82e5\u67e5\u8be2\u6539\u7528\u522b\u540d\uff0c\u5e94\u6839\u636e\u8be5\u8bf7\u6c42\u7684\u5b9e\u9645\u8bca\u65ad\u8def\u5f84\u8c03\u6574\u5339\u914d\u89c4\u5219\u3002\u4e0d\u8981\u628a\u591a\u4e2a\u8def\u5f84\u7684\u8bca\u65ad\u5408\u5e76\u6210\u4e00\u4efd\u6210\u529f\u7ed3\u8bba\u3002<\/p>\n
    \u7528\u5c0f\u51fd\u6570\u751f\u6210\u8fb9\u754c\u5e76\u4fdd\u7559\u4eba\u5de5\u9a8c\u6536\u5173\u53e3<\/h2>\n
    \u4ee5\u4e0b Python \u4ee3\u7801\u53ea\u5904\u7406\u5e26\u65f6\u533a\u65e5\u671f\u4e0e\u8bca\u65ad\u8bb0\u5f55\uff0c\u4e0d\u53d1\u9001 HTTP\u3002utc_filter<\/code> \u751f\u6210\u540c\u4e00 UTC \u8303\u56f4\uff1binspect_search<\/code> \u62d2\u7edd\u7f3a\u5931\u3001\u9519\u914d\u3001\u6709\u8b66\u544a\u6216\u6709\u9876\u5c42\u9519\u8bef\u7684\u8f93\u5165\u3002\u8fd4\u56de REVIEW_PARSED_SCOPE<\/code> \u7684\u542b\u4e49\u662f\u201c\u53ef\u4ee5\u5f00\u59cb\u4eba\u5de5\u6838\u5bf9 parsed\u201d\uff0c\u5e76\u975e\u81ea\u52a8\u786e\u8ba4 Shopify \u5df2\u6b63\u786e\u6267\u884c\u6240\u6709\u641c\u7d22\u6761\u4ef6\u3002<\/p>\n
    """Offline helpers for one bounded products search. No HTTP client."""\nfrom datetime import datetime, timezone\n\ndef utc_filter(lower, upper):\n    def parse(value):\n        stamp = datetime.fromisoformat(value.replace("Z", "+00:00"))\n        if "T" not in value or stamp.tzinfo is None:\n            raise ValueError("timezone-bearing datetime required")\n        return stamp.astimezone(timezone.utc)\n    start, end = parse(lower), parse(upper)\n    if start >= end:\n        raise ValueError("lower boundary must precede upper boundary")\n    fmt = lambda value: value.isoformat().replace("+00:00", "Z")\n    return f"updated_at:>='{fmt(start)}' updated_at:<'{fmt(end)}'"\n\ndef inspect_search(payload, expected_filter):\n    if not isinstance(payload, dict) or payload.get("errors"):\n        return "CHECK_RESPONSE_ERRORS", None\n    ext = payload.get("extensions")\n    diagnostics = ext.get("search") if isinstance(ext, dict) else None\n    if not isinstance(diagnostics, list):\n        return "NO_SEARCH_DIAGNOSTICS", None\n    matches = [entry for entry in diagnostics if isinstance(entry, dict)\n               and entry.get("path") == ["products"]]\n    if len(matches) != 1:\n        return "AMBIGUOUS_OR_MISSING_PATH", None\n    entry = matches[0]\n    if entry.get("query") != expected_filter:\n        return "FILTER_MISMATCH", None\n    warnings = entry.get("warnings", [])\n    if not isinstance(warnings, list):\n        return "UNCONFIRMED_WARNING_SHAPE", None\n    if warnings:\n        return "SEARCH_WARNINGS", warnings\n    if not isinstance(entry.get("parsed"), dict) or not entry["parsed"]:\n        return "NO_PARSED_DIAGNOSTIC", None\n    return "REVIEW_PARSED_SCOPE", entry["parsed"]\n<\/code><\/pre>\n
    \u8c03\u7528 inspect_search(payload, filter_value)<\/code> \u524d\uff0c\u5e94\u7531\u73b0\u6709\u8bf7\u6c42\u5c42\u68c0\u67e5 HTTP \u54cd\u5e94\u3001JSON \u89e3\u7801\u4e0e\u5b9e\u9645 API \u7248\u672c\u3002\u8fd9\u91cc\u6ca1\u6709\u5b9e\u73b0 Shopify \u641c\u7d22\u89e3\u6790\u5668\uff0c\u4e5f\u4e0d\u6839\u636e\u4e00\u4e2a\u56fa\u5b9a\u7684\u81ea\u9020 AST \u5f62\u72b6\u5224\u65ad\u7ebf\u4e0a\u8bed\u4e49\u3002\u82e5\u8fd8\u9700\u68c0\u67e5\u5355\u4e2a\u5546\u54c1\u7684\u5b57\u6bb5\u7c7b\u578b\u3001\u7a7a\u503c\u548c\u9519\u8bef\u54cd\u5e94\uff0c\u53ef\u53c2\u7167\u5546\u54c1\u54cd\u5e94\u5951\u7ea6\u4e0e\u5b57\u6bb5\u9a8c\u6536<\/a>\u3002<\/p>\n
    \u7528\u5c0f\u91cf\u53ea\u8bfb\u7ed3\u679c\u5b8c\u6210\u8fd9\u6b21\u6392\u67e5<\/h2>\n
    \u641c\u7d22\u8bca\u65ad\u901a\u8fc7\u4eba\u5de5\u6838\u5bf9\u540e\uff0c\u9010\u4e2a\u68c0\u67e5\u8fd4\u56de\u7684 id<\/code> \u4e0e updatedAt<\/code>\uff0c\u5c06\u65f6\u95f4\u8f6c\u6362\u4e3a UTC\uff0c\u518d\u6bd4\u8f83\u662f\u5426\u843d\u5728\u6240\u7ea6\u5b9a\u7684\u8303\u56f4\u5185\u3002\u5982\u679c\u6709\u5df2\u77e5\u66f4\u65b0\u65f6\u95f4\u7684\u6d4b\u8bd5\u5546\u54c1\uff0c\u53ef\u5728\u53d7\u63a7\u73af\u5883\u4e2d\u6838\u5bf9\u8fb9\u754c\u9644\u8fd1\u7684\u5bf9\u8c61\uff1b\u672c\u4f8b\u6ca1\u6709\u5728\u5546\u5bb6\u5e97\u94fa\u6267\u884c\u8be5\u6d4b\u8bd5\u3002<\/p>\n