{"id":22005,"date":"2026-03-22T17:31:59","date_gmt":"2026-03-22T08:31:59","guid":{"rendered":"https:\/\/cg-method.com\/figma\/?p=22005"},"modified":"2026-10-03T17:47:01","modified_gmt":"2026-10-03T08:47:01","slug":"figma-ghost-component-detection","status":"publish","type":"post","link":"https:\/\/cg-method.com\/figma\/figma-ghost-component-detection\/","title":{"rendered":"Figma API\u3067\u7a7a\u306e\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u691c\u51fa\u3059\u308b\u65b9\u6cd5\uff5c\u672a\u53d6\u5f97\u30fb\u524a\u9664\u3068\u306e\u9055\u3044"},"content":{"rendered":"\n

Figma REST API\u3067\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u53d6\u5f97\u3057\u305f\u3068\u304d\u3001children\u304c\u7a7a\u914d\u5217\u3067\u3082\u300c\u524a\u9664\u6e08\u307f\u300d\u3068\u306f\u65ad\u5b9a\u3067\u304d\u307e\u305b\u3093\u3002\u7a7a\u306e\u6709\u52b9\u306a\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3001\u53d6\u5f97\u6df1\u5ea6\u4e0d\u8db3\u3001\u53d6\u5f97\u3067\u304d\u306a\u3044\u30ce\u30fc\u30c9\u3092\u5206\u3051\u3066\u78ba\u8a8d\u3057\u307e\u3059\u3002\u3053\u306e\u8a18\u4e8b\u3067\u306f\u5143\u30c7\u30fc\u30bf\u3092\u6b8b\u3057\u305f\u307e\u307e\u78ba\u8a8d\u5019\u88dc\u3092\u62bd\u51fa\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

\u7a7a\u30fb\u672a\u53d6\u5f97\u30fb\u53d6\u5f97\u4e0d\u53ef\u3092\u5206\u3051\u308b<\/h2>\n\n\n\n
\u53d6\u5f97\u72b6\u614b<\/th>\u8a18\u9332\u5148<\/th>\u5224\u65ad<\/th><\/tr><\/thead>
COMPONENT\u3067children\u304c\u7a7a\u914d\u5217<\/td>reviewIds<\/td>\u7a7a\u306e\u78ba\u8a8d\u5019\u88dc\u3002\u524a\u9664\u306e\u8a3c\u62e0\u3067\u306f\u306a\u3044<\/td><\/tr>
COMPONENT\u3067children\u304c\u306a\u3044<\/td>childrenUnknownIds<\/td>\u5b50\u8981\u7d20\u306e\u53d6\u5f97\u6761\u4ef6\u3092\u78ba\u8a8d\u3059\u308b<\/td><\/tr>
nodes\u5185\u306e\u5024\u304cnull\u3001document\u304c\u306a\u3044<\/td>unavailableIds<\/td>\u5bfe\u8c61\u30d5\u30a1\u30a4\u30eb\u30fbID\u30fb\u30a2\u30af\u30bb\u30b9\u3092\u78ba\u8a8d\u3059\u308b<\/td><\/tr>
\u5b50\u8981\u7d20\u304c\u3042\u308b<\/td>names\u306b\u4fdd\u6301<\/td>\u4eca\u56de\u306e\u7a7a\u5019\u88dc\u306b\u306f\u542b\u3081\u306a\u3044<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

\u300c\u5e7d\u970a\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u300d\u306f\u672c\u30b5\u30a4\u30c8\u3067\u4f7f\u3063\u3066\u3044\u305f\u4fbf\u5b9c\u7684\u306a\u547c\u3073\u65b9\u3067\u3001\u516c\u5f0f\u306e\u524a\u9664\u72b6\u614b\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u30ad\u30e3\u30c3\u30b7\u30e5\u304c\u539f\u56e0\u3068\u6c7a\u3081\u3064\u3051\u305a\u3001\u540c\u3058\u30d5\u30a1\u30a4\u30eb\u3001\u30ce\u30fc\u30c9ID\u3001\u30d5\u30a1\u30a4\u30eb\u7248\u3092\u7167\u5408\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

nodes\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8\u3092depth=1\u3067\u53d6\u5f97\u3059\u308b<\/h2>\n\n\n\n

GET \/v1\/files\/:key\/nodes\u3067\u306fdepth=1\u304c\u6307\u5b9a\u30ce\u30fc\u30c9\u306e\u76f4\u4e0b\u306e\u5b50\u8981\u7d20\u3092\u8fd4\u3057\u307e\u3059\u3002\u30d5\u30a1\u30a4\u30eb\u5168\u4f53\u306eGET \/v1\/files\/:key\u3067\u306fdepth=1\u304cPages\u3092\u8fd4\u3059\u305f\u3081\u3001\u540c\u3058\u6570\u5b57\u3067\u3082\u53d6\u5f97\u7bc4\u56f2\u304c\u7570\u306a\u308a\u307e\u3059\u3002depth\u306f\u6b63\u306e\u6574\u6570\u3067\u6307\u5b9a\u3057\u30010\u306f\u4f7f\u3044\u307e\u305b\u3093\u3002<\/p>\n\n\n\n

\u5bfe\u8c61\u306e\u30ce\u30fc\u30c9ID\u3092ids\u3067\u6307\u5b9a\u3057\u3001\u53d6\u5f97\u7d50\u679c\u306enodes\u3092\u6b21\u306e\u95a2\u6570\u3078\u6e21\u3057\u307e\u3059\u3002URL\u751f\u6210\u3068\u5206\u985e\u306e\u95a2\u6570\u3067\u3042\u308a\u3001\u8a8d\u8a3c\u30fbHTTP\u30ea\u30af\u30a8\u30b9\u30c8\u306f\u542b\u307f\u307e\u305b\u3093\u3002\u65e2\u5b58\u306e\u53d6\u5f97\u51e6\u7406\u306b\u7d44\u307f\u8fbc\u307f\u3001file_content:read\u306e\u30b9\u30b3\u30fc\u30d7\u3068\u30d5\u30a1\u30a4\u30eb\u306e\u95b2\u89a7\u6a29\u9650\u3092\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/p>\n\n\n\n

\u51fa\u5178\uff1aREST API\u306e\u30d5\u30a1\u30a4\u30eb\u30a8\u30f3\u30c9\u30dd\u30a4\u30f3\u30c8<\/a>\u3002<\/p>\n\n\n\n

code.js<\/h3>\n\n\n\n
function buildNodesUrl(fileKey, nodeIds) {\n  if (!fileKey || !Array.isArray(nodeIds) || nodeIds.length === 0)\n    throw new Error("\u30d5\u30a1\u30a4\u30eb\u30ad\u30fc\u3068\u30ce\u30fc\u30c9ID\u304c\u5fc5\u8981\u3067\u3059");\n  return "https:\/\/api.figma.com\/v1\/files\/" + encodeURIComponent(fileKey) +\n    "\/nodes?depth=1&ids=" + encodeURIComponent(nodeIds.join(","));\n}\nfunction buildNodeMap(nodes) {\n  const names = Object.create(null);\n  const reviewIds = [], unavailableIds = [], childrenUnknownIds = [];\n  for (const id of Object.keys(nodes || {})) {\n    const entry = nodes[id];\n    const doc = entry && entry.document;\n    if (!doc) { unavailableIds.push(id); continue; }\n    names[id] = doc.name;\n    if (doc.type !== "COMPONENT") continue;\n    if (!Array.isArray(doc.children)) childrenUnknownIds.push(id);\n    else if (doc.children.length === 0) reviewIds.push(id);\n  }\n  return { names, reviewIds, unavailableIds, childrenUnknownIds };\n}<\/code><\/pre><\/div>\n\n\n\n
\u5224\u5b9a\u7d50\u679c\u3092\u4f7f\u3046\u3068\u304d\u306e\u624b\u9806<\/h2>\n\n\n\n
  1. \u6210\u529f\u3057\u305fHTTP\u30ec\u30b9\u30dd\u30f3\u30b9\u306enodes\u3092\u5206\u985e\u3057\u307e\u3059\u3002HTTP\u5931\u6557\u3092\u7a7a\u30c7\u30fc\u30bf\u3068\u3057\u3066\u6271\u3044\u307e\u305b\u3093\u3002<\/li>
  2. reviewIds\u306e\u30ce\u30fc\u30c9\u3092\u5143\u30d5\u30a1\u30a4\u30eb\u3067\u958b\u304d\u3001\u7a7a\u306e\u90e8\u54c1\u3068\u3057\u3066\u5fc5\u8981\u304b\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/li>
  3. childrenUnknownIds\u306f\u53d6\u5f97\u6df1\u5ea6\u3068\u30ec\u30b9\u30dd\u30f3\u30b9\u3092\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/li>
  4. unavailableIds\u306f\u5b58\u5728\u3057\u306a\u3044ID\u3068\u6c7a\u3081\u3064\u3051\u305a\u3001\u30d5\u30a1\u30a4\u30eb\u30fb\u7248\u30fb\u6a29\u9650\u3092\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/li>
  5. \u9664\u5916\u304c\u5fc5\u8981\u3068\u78ba\u5b9a\u3057\u305fID\u3060\u3051\u3001\u9023\u643a\u5148\u306e\u4e00\u89a7\u306b\u53cd\u6620\u3057\u307e\u3059\u3002<\/li><\/ol>\n\n\n\n
    \u3053\u306e\u30b3\u30fc\u30c9\u306b\u524a\u9664\u51e6\u7406\u306f\u3042\u308a\u307e\u305b\u3093\u3002names\u306b\u7a7a\u306e\u5019\u88dc\u3082\u6b8b\u3057\u3001\u53d6\u5f97\u3057\u305f\u60c5\u5831\u3068\u5224\u65ad\u5f8c\u306e\u60c5\u5831\u3092\u5206\u3051\u307e\u3059\u3002\u540d\u524d\u3060\u3051\u3067\u9664\u5916\u3059\u308b\u3068\u3001\u540c\u540d\u306e\u5225\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u843d\u3068\u3059\u53ef\u80fd\u6027\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n\n\n\n
    \u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u306e\u53c2\u7167\u5143\u3092\u8abf\u3079\u308b\u5834\u5408\u306f\u3001API\u3068Plugin API\u306e\u6bd4\u8f03<\/a>\u3067\u51e6\u7406\u5834\u6240\u3092\u9078\u3073\u307e\u3059\u3002<\/p>\n\n\n\n
    \u691c\u8a3c\u7bc4\u56f2\u3068\u95a2\u9023\u30ac\u30a4\u30c9<\/h2>\n\n\n\n
    \u4eca\u56de\u78ba\u8a8d\u3057\u305f\u306e\u306f\u63b2\u8f09\u30b3\u30fc\u30c9\u306e\u69cb\u6587\u3068\u3001\u8a72\u5f53\u3059\u308b\u5165\u529b\u30fb\u4f8b\u5916\u51e6\u7406\u306e\u30ed\u30fc\u30ab\u30eb\u6a21\u64ec\u691c\u8a3c\u3067\u3059\u3002Figma\u30c7\u30b9\u30af\u30c8\u30c3\u30d7\u30a2\u30d7\u30ea\u4e0a\u3067\u306e\u52d5\u4f5c\u78ba\u8a8d\u3068\u306f\u533a\u5225\u3057\u3066\u3044\u307e\u3059\u3002\u6539\u7a3f\u5f8c\u306e\u30b3\u30fc\u30c9\u3068\u3001\u5143\u8a18\u4e8b\u304c\u53c2\u7167\u3057\u3066\u3044\u305fGitHub\u4e0a\u306e\u7248\u304c\u4e00\u81f4\u3059\u308b\u3068\u306f\u9650\u308a\u307e\u305b\u3093\u3002<\/p>\n\n\n\n
    \u958b\u767a\u74b0\u5883\u3068\u767b\u9332\u624b\u9806\u306fFigma\u30d7\u30e9\u30b0\u30a4\u30f3\u958b\u767a\u5165\u9580<\/a>\u3001\u516c\u958b\u306fCommunity\u3078\u306e\u7533\u8acb<\/a>\u3092\u53c2\u7167\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
    Figma REST API\u3067\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u53d6\u5f97\u3057\u305f\u3068\u304d\u3001children\u304c\u7a7a\u914d\u5217\u3067\u3082\u300c\u524a\u9664\u6e08\u307f\u300d\u3068\u306f\u65ad\u5b9a\u3067\u304d\u307e\u305b\u3093\u3002\u7a7a\u306e\u6709\u52b9\u306a\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3001\u53d6\u5f97\u6df1\u5ea6\u4e0d\u8db3\u3001\u53d6\u5f97\u3067\u304d\u306a\u3044\u30ce\u30fc\u30c9\u3092\u5206\u3051\u3066\u78ba\u8a8d\u3057\u307e\u3059\u3002\u3053\u306e\u8a18\u4e8b\u3067\u306f\u5143\u30c7\u30fc\u30bf\u3092 […]<\/p>\n","protected":false},"author":1,"featured_media":22007,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"swell_btn_cv_data":"","book_review_data":"","footnotes":"","ssp_meta_title":"Figma API\u3067\u7a7a\u306e\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u691c\u51fa\u3059\u308b\u65b9\u6cd5\uff5c\u672a\u53d6\u5f97\u30fb\u524a\u9664\u3068\u306e\u9055\u3044","ssp_meta_description":"Figma REST API\u3067\u7a7a\u306e\u30b3\u30f3\u30dd\u30fc\u30cd\u30f3\u30c8\u3092\u691c\u51fa\u3059\u308b\u65b9\u6cd5\u3002depth=1\u3001children\u306e\u7a7a\u30fb\u672a\u53d6\u5f97\u3001nodes\u306enull\u3092\u5206\u3051\u3001\u524a\u9664\u6e08\u307f\u3068\u65ad\u5b9a\u305b\u305a\u78ba\u8a8d\u5019\u88dc\u3092\u8a18\u9332\u3059\u308b\u30b3\u30fc\u30c9\u3092\u7d39\u4ecb\u3057\u307e\u3059\u3002"},"categories":[145],"tags":[],"class_list":["post-22005","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-figma-tools"],"_links":{"self":[{"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/posts\/22005","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/comments?post=22005"}],"version-history":[{"count":9,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/posts\/22005\/revisions"}],"predecessor-version":[{"id":22580,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/posts\/22005\/revisions\/22580"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/media\/22007"}],"wp:attachment":[{"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/media?parent=22005"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/categories?post=22005"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cg-method.com\/figma\/wp-json\/wp\/v2\/tags?post=22005"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}