이동 작업
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
바로가기 액션을 사용하면 사용자가 액션을 완료할 수 있는 웹사이트로 이동합니다. 원클릭 작업과 달리 이동 작업은 여러 번 상호작용할 수 있습니다.
Gmail의 이동 작업
사용 사례
현재 Gmail에서 지원하는 바로가기 작업은 다음과 같습니다.
향후 더 많은 작업이 지원될 수 있습니다.
작업 보기
사용자가 작업을 완료하기 위해 사이트로 이동해야 하는 이메일에 ViewAction
버튼을 추가할 수 있습니다.
다음 선언은 이메일에 ViewAction
버튼을 추가합니다.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"url": "https://watch-movies.com/watch?movieId=abc123",
"name": "Watch movie"
},
"description": "Watch the 'Avengers' movie online"
}
</script>
마이크로데이터
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
<meta itemprop="name" content="Watch movie"/>
</div>
<meta itemprop="description" content="Watch the 'Avengers' movie online"/>
</div>
게시자 데이터
publisher
필드를 설정하여 이메일 메시지를 보내는 조직에 관한 세부정보를 추가할 수 있습니다.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"description": "Watch the 'Avengers' movie online",
"potentialAction": {
"@type": "ViewAction",
"url": "https://watch-movies.com/watch?movieId=abc123",
"name": "Watch movie"
},
"publisher": {
"@type": "Organization",
"name": "Google Play",
"url": "https://play.google.com",
"url/googlePlus": "https://plus.google.com/106886664866983861036"
}
}
</script>
마이크로데이터
<div itemscope itemtype="http://schema.org/EmailMessage">
<meta itemprop="description" content="Watch the 'Avengers' movie online"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
<meta itemprop="name" content="Watch movie"/>
</div>
<div itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Google Play"/>
<link itemprop="url" href="https://play.google.com"/>
<link itemprop="url/googlePlus" href="https://plus.google.com/106886664866983861036"/>
</div>
</div>
Track Action
사용자가 배송 중인 상품을 추적하기 위해 사이트로 이동해야 하는 이메일에 TrackAction
버튼을 추가할 수 있습니다.
trackingUrl
속성을 지정하면 작업이 자동으로 생성됩니다. 모바일 애플리케이션에 직접 연결하려면 다음과 같이 TrackAction
도 포함하세요.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"expectedArrivalUntil": "2013-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": "FedEx"
},
"itemShipped": {
"@type": "Product",
"name": "iPod Mini"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": "176057",
"merchant": {
"@type": "Organization",
"name": "Bob Dole"
}
},
"trackingUrl": "http://fedex.com/track/1234567890"
"potentialAction": {
"@type": "TrackAction",
"target": "http://fedex.com/track/1234567890"
},
}
</script>
마이크로데이터
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<meta itemprop="expectedArrivalUntil" content="2013-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="FedEx"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="iPod Mini"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="176057"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bob Dole"/>
</div>
</div>
<link itemprop="trackingUrl" href="http://fedex.com/track/1234567890"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/TrackAction">
<link itemprop="target" href="http://fedex.com/track/1234567890"/>
</div>
</div>
마크업 테스트
이메일 마크업 테스터 도구를 사용하여 마크업의 유효성을 검사할 수 있습니다. 마크업 코드를 붙여넣고 유효성 검사 버튼을 클릭하여 콘텐츠를 스캔하고 오류가 있는 경우 보고서를 받습니다.
사양
다양한 이동 작업 유형의 사양은 특정 유형 ViewAction 또는 TrackAction의 문서를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Go-To Actions take the user to your website where the action can be completed. Unlike [One Click Actions](/workspace/gmail/markup/reference/one-click-action), go-to actions can be interacted with multiple times.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nGo-to actions in Gmail.\n\n\u003cbr /\u003e\n\nUse Cases\n---------\n\nGo-To Actions currently supported by Gmail are:\n\n- [ViewAction](#view_action)\n- [TrackAction](#track_action)\n\nMore actions might be supported in the future.\n| **Note:** Before you start, make sure you understand how to [embed schemas in emails](/workspace/gmail/markup/embedding-schemas-in-emails) and you are familiar with [testing schemas](/workspace/gmail/markup/testing-your-schema).\n\nView Action\n-----------\n\nYou can add a `ViewAction` button to emails requiring users to go to your site to complete the action.\n\nThe following declaration adds a `ViewAction` button to an email: \n\n### JSON-LD\n\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"EmailMessage\",\n \"potentialAction\": {\n \"@type\": \"ViewAction\",\n \"url\": \"https://watch-movies.com/watch?movieId=abc123\",\n \"name\": \"Watch movie\"\n },\n \"description\": \"Watch the 'Avengers' movie online\"\n }\n \u003c/script\u003e\n\n### Microdata\n\n \u003cdiv itemscope itemtype=\"http://schema.org/EmailMessage\"\u003e\n \u003cdiv itemprop=\"potentialAction\" itemscope itemtype=\"http://schema.org/ViewAction\"\u003e\n \u003clink itemprop=\"target\" href=\"https://watch-movies.com/watch?movieId=abc123\"/\u003e\n \u003cmeta itemprop=\"name\" content=\"Watch movie\"/\u003e\n \u003c/div\u003e\n \u003cmeta itemprop=\"description\" content=\"Watch the 'Avengers' movie online\"/\u003e\n \u003c/div\u003e\n\n### Publisher data\n\nYou can add details about the organization sending the email message by setting the `publisher` field: \n\n### JSON-LD\n\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"EmailMessage\",\n \"description\": \"Watch the 'Avengers' movie online\",\n \"potentialAction\": {\n \"@type\": \"ViewAction\",\n \"url\": \"https://watch-movies.com/watch?movieId=abc123\",\n \"name\": \"Watch movie\"\n },\n \"publisher\": {\n \"@type\": \"Organization\",\n \"name\": \"Google Play\",\n \"url\": \"https://play.google.com\",\n \"url/googlePlus\": \"https://plus.google.com/106886664866983861036\"\n }\n }\n \u003c/script\u003e\n\n### Microdata\n\n \u003cdiv itemscope itemtype=\"http://schema.org/EmailMessage\"\u003e\n \u003cmeta itemprop=\"description\" content=\"Watch the 'Avengers' movie online\"/\u003e\n \u003cdiv itemprop=\"potentialAction\" itemscope itemtype=\"http://schema.org/ViewAction\"\u003e\n \u003clink itemprop=\"target\" href=\"https://watch-movies.com/watch?movieId=abc123\"/\u003e\n \u003cmeta itemprop=\"name\" content=\"Watch movie\"/\u003e\n \u003c/div\u003e\n \u003cdiv itemprop=\"publisher\" itemscope itemtype=\"http://schema.org/Organization\"\u003e\n \u003cmeta itemprop=\"name\" content=\"Google Play\"/\u003e\n \u003clink itemprop=\"url\" href=\"https://play.google.com\"/\u003e\n \u003clink itemprop=\"url/googlePlus\" href=\"https://plus.google.com/106886664866983861036\"/\u003e\n \u003c/div\u003e\n \u003c/div\u003e\n\nTrack Action\n------------\n\nYou may add a `TrackAction` button to emails requiring users to go to your site to track packages being delivered.\n\nAn action is automatically generated when you specify the `trackingUrl` property. To link directly to a mobile application,\nalso include a `TrackAction` as shown: \n\n### JSON-LD\n\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"ParcelDelivery\",\n \"deliveryAddress\": {\n \"@type\": \"PostalAddress\",\n \"streetAddress\": \"24 Willie Mays Plaza\",\n \"addressLocality\": \"San Francisco\",\n \"addressRegion\": \"CA\",\n \"addressCountry\": \"US\",\n \"postalCode\": \"94107\"\n },\n \"expectedArrivalUntil\": \"2013-03-12T12:00:00-08:00\",\n \"carrier\": {\n \"@type\": \"Organization\",\n \"name\": \"FedEx\"\n },\n \"itemShipped\": {\n \"@type\": \"Product\",\n \"name\": \"iPod Mini\"\n },\n \"partOfOrder\": {\n \"@type\": \"Order\",\n \"orderNumber\": \"176057\",\n \"merchant\": {\n \"@type\": \"Organization\",\n \"name\": \"Bob Dole\"\n }\n },\n \"trackingUrl\": \"http://fedex.com/track/1234567890\"\n \"potentialAction\": {\n \"@type\": \"TrackAction\",\n \"target\": \"http://fedex.com/track/1234567890\"\n },\n }\n \u003c/script\u003e\n\n### Microdata\n\n \u003cdiv itemscope itemtype=\"http://schema.org/ParcelDelivery\"\u003e\n \u003cdiv itemprop=\"deliveryAddress\" itemscope itemtype=\"http://schema.org/PostalAddress\"\u003e\n \u003cmeta itemprop=\"streetAddress\" content=\"24 Willie Mays Plaza\"/\u003e\n \u003cmeta itemprop=\"addressLocality\" content=\"San Francisco\"/\u003e\n \u003cmeta itemprop=\"addressRegion\" content=\"CA\"/\u003e\n \u003cmeta itemprop=\"addressCountry\" content=\"US\"/\u003e\n \u003cmeta itemprop=\"postalCode\" content=\"94107\"/\u003e\n \u003c/div\u003e\n \u003cmeta itemprop=\"expectedArrivalUntil\" content=\"2013-03-12T12:00:00-08:00\"/\u003e\n \u003cdiv itemprop=\"carrier\" itemscope itemtype=\"http://schema.org/Organization\"\u003e\n \u003cmeta itemprop=\"name\" content=\"FedEx\"/\u003e\n \u003c/div\u003e\n \u003cdiv itemprop=\"itemShipped\" itemscope itemtype=\"http://schema.org/Product\"\u003e\n \u003cmeta itemprop=\"name\" content=\"iPod Mini\"/\u003e\n \u003c/div\u003e\n \u003cdiv itemprop=\"partOfOrder\" itemscope itemtype=\"http://schema.org/Order\"\u003e\n \u003cmeta itemprop=\"orderNumber\" content=\"176057\"/\u003e\n \u003cdiv itemprop=\"merchant\" itemscope itemtype=\"http://schema.org/Organization\"\u003e\n \u003cmeta itemprop=\"name\" content=\"Bob Dole\"/\u003e\n \u003c/div\u003e\n \u003c/div\u003e\n \u003clink itemprop=\"trackingUrl\" href=\"http://fedex.com/track/1234567890\"/\u003e\n \u003cdiv itemprop=\"potentialAction\" itemscope itemtype=\"http://schema.org/TrackAction\"\u003e\n \u003clink itemprop=\"target\" href=\"http://fedex.com/track/1234567890\"/\u003e\n \u003c/div\u003e\n \u003c/div\u003e\n\nTest your markup\n----------------\n\nYou can validate your markup using the [Email Markup Tester Tool](https://www.google.com/webmasters/markup-tester/). Paste in your markup code and click the **Validate** button to scan the content and receive a report on any errors present.\n\nSpecification\n-------------\n\nFor a specification of the various go-to action types, see the documentation\nfor the specific type [ViewAction](/workspace/gmail/markup/reference/types/ViewAction) or\n[TrackAction](/workspace/gmail/markup/reference/types/TrackAction).\n| **Note:** Some of the schemas used by Google are still going through the standardization process of [schema.org](http://schema.org), and therefore, may change in the future. [Learn More](/workspace/gmail/markup/reference/schema-org-proposals)."]]