📘 公式リファレンス📦 リファレンス/オブジェクト初級

user_agent オブジェクト

robots.txt ファイル内のユーザーエージェント指定を表すオブジェクト。各クローラーグループの User-agent ディレクティブと値を格納する。

用途

robots.txt.liquid テンプレートでクローラー（Google、Bing など）ごとのクロール制御ルールを定義するとき、ユーザーエージェント名を条件分岐や出力に使う。

設置場所

robots.txt.liquid テンプレート内で `{{ robots.default_groups[0].user_agent.directive }}` または `{{ robots.default_groups[0].user_agent.value }}` の形で参照し、ディレクティブ行またはクローラー名を出力する。

注意点

user_agent オブジェクトは robots グループ配下の親オブジェクトとしてのみアクセス可能で、グローバルスコープでの直接参照はできない。directive プロパティは常に「User-agent」文字列を返し、value プロパティがクローラー名（「*」「Googlebot」等）を返す。robots.txt のカスタマイズは robots.txt.liquid テンプレートでのみ可能。

タグ:robots-txtseocrawlerrequest-filtering

仕様

58 行 / json

{
  "access": {
    "global": false,
    "parents": [
      {
        "object": "group",
        "property": "user_agent"
      }
    ],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `user_agent` object consists of a `User-agent` directive, and a value of the name of the user-agent. For example:\n\n```\nUser-agent: *\n```\n\n&gt; Tip:\n&gt; You can [customize the `robots.txt` file](/themes/seo/robots-txt) with the [`robots.txt.liquid` template](/themes/architecture/templates/robots-txt-liquid).",
  "properties": [
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "Returns `User-agent`.",
      "name": "directive"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The name of the user-agent.",
      "name": "value"
    }
  ],
  "summary": "The user-agent, which is the name of the crawler, for a specific group in the [`robots.txt` file](/themes/architecture/templates/robots-txt-liquid).",
  "name": "user_agent",
  "examples": [],
  "json_data": {
    "path": "/robots.txt",
    "handle": "robots.default_groups[0].user_agent",
    "data_from_file": ""
  },
  "return_type": []
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/objects.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

user_agent オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト