피드 사양

필수 및 권장 필드

다음은 설명자 파일 및 이벤트 피드의 필수 및 권장 필드 목록입니다. 언급되지 않은 모든 필드는 선택사항으로 간주됩니다.

팁: 이 페이지를 사용하여 이벤트 피드의 구조와 필드를 이해하세요. 그런 다음 피드를 더 최적화하려면 이벤트 가시성 최적화에서 다양한 표시 경로에서 이벤트의 가시성을 개선하는 권장사항을 확인하세요.

설명자 파일

필드	필수 / 권장	참고
generation_timestamp	필수
name	필수	event.feeddata.v1로 설정해야 합니다.
data_file	필수

이벤트 피드

필드	공연 무대 모듈	아티스트 / 스포츠 모듈	참고
EventFeed.data	필수	필수	모든 데이터를 삭제하기 위해 빈 목록일 수 있습니다.
Event.id	필수	필수
Event.description	추천	추천
Event.time_info	필수	필수
Event.time_info.start_seconds	필수	필수
Event.venue	필수	필수
Event.venue.id	필수	필수
Event.venue.location	필수	필수	위치를 제공하려면 다음 속성 중 정확히 하나를 입력해야 합니다. 여러 속성을 전송하면 인벤토리가 실패할 수 있습니다. Event.venue.location.place_id Event.venue.location.place_info Event.venue.location.business_profile_id 권장사항은 이벤트 공개 상태 최적화를 참고하세요.
Event.related_entities	추천	필수	권장사항은 이벤트 공개 상태 최적화를 참조하세요.
Event.tickets	티켓이 있는 경우 필수	티켓이 있는 경우 필수
Event.related_media	추천	추천
Event.url	필수	필수
Event.event_creator	사용자 제작 콘텐츠에 필요함	사용자 제작 콘텐츠에 필요함
Entity.id	추천	추천
Entity.name	필수	필수
Entity.official_website_url	추천	추천
Entity.url	추천	추천
Entity.musicbrainz_id	뮤직 아티스트에게 권장됨	뮤직 아티스트에게 권장됨
Entity.entity_type	선택사항	추천
Entity.performer_role	선택사항	추천
Ticket.id	필수	필수
Ticket.title	추천	추천
Ticket.description	추천	추천
Ticket.referral_urls	필수	필수	제공된 URL은 http://를 포함한 전체 경로여야 하며, 안전상의 이유로 TinyURL과 같은 리디렉션 서비스는 허용되지 않습니다.
Ticket.price	추천	추천	가격을 전송할 때 티켓 가격에 수수료가 포함되지 않은 경우 수수료 분석이 필요합니다.
Ticket.price.price_display_type	필수	필수	가격이 표시되는 방식을 결정합니다. 자세한 내용은 구현 참고사항을 확인하세요.
Ticket.availability_info	추천	추천	시간은 UNIX 타임스탬프이므로 이벤트 시간은 이에 상응하는 UTC 시간으로 변환해야 합니다.
Ticket.inventory_type	필수	필수
Ticket.eligibility_restriction	선택사항	선택사항	티켓 요금에 자격 제한이 있는지 여부를 나타냅니다 (UNKNOWN, NONE, CHILD, OTHER).

설명자 파일 사양

설명자 파일은 업로드하는 피드 유형을 Google 시스템에 알리기 위해 업로드됩니다. 이렇게 하면 피드를 올바르게 검증하고 처리할 수 있습니다. 설명자 파일은 피드 콘텐츠 전에 업로드해야 하며 다음 이름 지정 요구사항을 따라야 합니다.

• 설명자 파일에 .filesetdesc.json 파일 확장자를 사용해야 합니다.
• 각 설명자 파일 이름은 고유해야 하며 업로드 간에 재사용할 수 없습니다. 파일 이름에 생성 타임스탬프와 피드 이름을 포함하는 것이 좋습니다.
  • 예: event.feeddata.v1_1524606581.filesetdesc.json

• 각 설명자 파일은 관련 피드 이름의 최신 피드에 있는 모든 데이터 파일을 나열해야 합니다.

Proto

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

중요: 이벤트의 경우 name 필드를 'event.feeddata.v1'로 설정해야 합니다.

예

{
  "generation_timestamp": 1524606581,
  "name": "event.feeddata.v1",
  "data_file": [
    "file1_1524606581_1.json",
    "file2_1524606581_2.json"
  ]
}

JSON 피드 사양

JSON 피드 사양은 파트너가 사용해야 하는 이벤트 피드 콘텐츠의 형식을 정의합니다.

EventFeed 정의

Proto

message EventFeed {
  // List of the events.
  repeated Event data = 1;
}

예

{
  "data": [
    {
      "id": "123456-abc",
      "title": {
        "localized_texts": [
          {
            "text": "Summer Concert Series",
            "language_code": "en-US"
          },
          {
            "text": "Serie de conciertos de verano",
            "language_code": "es-ES"
          }
        ]
      },
      "description": {
        "localized_texts": [
          {
            "text": "<h1>Summer Concert Series</h1><p>Join us for our annual summer concert series featuring a variety of local artists.</p>",
            "language_code": "en-US"
          }
        ]
      },
      "time_info": {
        "start_seconds": 1695686400,
        "end_seconds": 1695700800,
        "door_open_seconds": 1695684600
      },
      "venue": {
        "id": "example_1",
        "location": {
          "place_info": {
            "name": "A place",
            "structured_address": {
              "country_code": "US",
              "postal_code": "94043",
              "locality": "Mountain View",
              "street_address": "1600 Amphitheatre Pkwy"
            }
          }
        }
      },
      "related_entities": [
        {
          "id": "7890",
          "name": {
            "text": "The Music Band",
            "language_code": "en-US"
          },
          "entity_type": "ENTITY_TYPE_PERFORMER_MUSICIAN",
          "performer_role": "PERFORMER_ROLE_HEADLINER"
        }
      ],
      "event_types": ["EVENT_TYPE_CONCERT"],
      "tickets": [
        {
          "id": "general-admission",
          "title": {
            "localized_texts": [
              {
                "text": "General Admission",
                "language_code": "en-US"
              }
            ]
          },
          "inventory_type": "INVENTORY_TYPE_PRIMARY",
          "seller_info": {
            "name": {
              "localized_texts": [
                {
                  "text": "Example Seller",
                  "language_code": "en-US"
                }
              ]
            },
            "logo_url": "https://www.example.com/images/fav-icon.png"
          },
          "referral_urls": [
            {
              "link": {
                "url": "https://www.example.com/tickets/123456-abc/general-admission"
              },
              "surface": "SURFACE_SEARCH"
            }
          ],
          "price": {
            "value": {
              "currency_code": "USD",
              "units": 25,
              "nanos": 190000000
            },
            "per_ticket_fee": {
              "currency_code": "USD",
              "units": 0
            },
            "per_ticket_tax": {
              "currency_code": "USD",
              "units": 0
            },
            "price_display_type": "PRICE_DISPLAY_TYPE_ALL_IN"
          },
          "availability_info": {
            "spots_available": 100
          }
        }
      ],
      "related_media": [
        {
          "url": "https://www.example.com/images/summer-concert-series.jpg",
          "type": "MEDIA_TYPE_PHOTO"
        }
      ],
      "event_url": {
        "url": "https://www.example.com/events/123456-abc",
        "localized_url": {
          "localized_texts": [
            {
              "text": "https://www.example.com/events/123456-abc?hl=en-US",
              "language_code": "en-US"
            },
            {
              "text": "https://www.example.com/events/123456-abc?hl=es-ES",
              "language_code": "es-ES"
            }
          ]
        }
      }
    },
    {
      "id": "987654-xyz",
      "title": {
        "localized_texts": [
          {
            "text": "Music Festival",
            "language_code": "en-US"
          }
        ]
      },
      "description": {
        "localized_texts": [
          {
            "text": "<h2>Music Festival</h2><p>Come and experience a weekend of live music, food, and fun at our annual music festival.</p>",
            "language_code": "en-US"
          }
        ]
      },
      "time_info": {
        "start_seconds": 1696118400,
        "end_seconds": 1696132800
      },
      "venue": {
        "id": "example_2",
        "location": {
          "place_id": "ChIJZQ9p9bUuEmsRRo6LwtmQvXU"
        }
      },
      "related_entities": [
        {
          "id": "4567",
          "name": {
            "text": "Pop Superstar",
            "language_code": "en-US"
          },
          "entity_type": "ENTITY_TYPE_PERFORMER_MUSICIAN"
        }
      ],
      "event_types": ["EVENT_TYPE_CONCERT"],
      "tickets": [
        {
          "id": "single-day-pass",
          "title": {
            "localized_texts": [
              {
                "text": "Single Day Pass",
                "language_code": "en-US"
              }
            ]
          },
          "inventory_type": "INVENTORY_TYPE_PRIMARY",
          "referral_urls": [
            {
              "link": {
                "url": "https://www.example.com/tickets/987654-xyz/single-day-pass"
              }
            }
          ],
          "price": {
            "value": {
              "currency_code": "USD",
              "units": 99,
              "nanos": 990000000
            },
            "per_ticket_fee": {
              "currency_code": "USD",
              "units": 5,
              "nanos": 990000000
            },
            "per_ticket_tax": {
              "currency_code": "USD",
              "units": 1,
              "nanos": 750000000
            },
            "price_display_type": "PRICE_DISPLAY_TYPE_BASE"
          },
          "availability_info": {
            "spots_available": 500
          }
        }
      ],
      "event_url": {
        "url": "https://www.example.com/events/987654-xyz"
      }
    },
    {
      "id": "987654-1234567",
      "title": {
        "localized_texts": [
          {
            "text": "Team Red vs Team Blue",
            "language_code": "en-US"
          }
        ]
      },
      "description": {
        "localized_texts": [
          {
            "text": "<h2>Sports match between two teams.</p>",
            "language_code": "en-US"
          }
        ]
      },
      "time_info": {
        "start_seconds": 1696118400,
        "end_seconds": 1696132800
      },
      "venue": {
        "id": "example_3",
        "location": {
          "place_id": "ChIJZQ9p9bUuEmsRRo6LwtmQvXU"
        }
      },
      "related_entities": [
        {
          "id": "4567",
          "name": {
            "text": "Team Red",
            "language_code": "en-US"
          },      
          "official_website_url": "https://www.example.com/team-red",
          "entity_type": "ENTITY_TYPE_PERFORMER_SPORTS_TEAM",
          "performer_role": "PERFORMER_ROLE_HOME_TEAM"
        },
        {
          "id": "4568",
          "name": {
            "text": "Team Blue",
            "language_code": "en-US"
          },
          "official_website_url": "https://www.example.com/team-blue",
          "entity_type": "ENTITY_TYPE_PERFORMER_SPORTS_TEAM",
          "performer_role": "PERFORMER_ROLE_AWAY_TEAM"
        }
      ],
      "event_types": ["EVENT_TYPE_SPORTS"],
      "tickets": [
        {
          "id": "single-match-pass",
          "title": {
            "localized_texts": [
              {
                "text": "Single Match Pass",
                "language_code": "en-US"
              }
            ]
          },
          "inventory_type": "INVENTORY_TYPE_PRIMARY",
          "referral_urls": [
            {
              "link": {
                "url": "https://www.example.com/tickets/987654-xyz/single-day-pass"
              }
            }
          ],
          "price": {
            "value": {
              "currency_code": "USD",
              "units": 99,
              "nanos": 990000000
            },
            "per_ticket_fee": {
              "currency_code": "USD",
              "units": 5,
              "nanos": 990000000
            },
            "per_ticket_tax": {
              "currency_code": "USD",
              "units": 1,
              "nanos": 750000000
            },
            "price_display_type": "PRICE_DISPLAY_TYPE_BASE"
          },
          "availability_info": {
            "spots_available": 500
          }
        }
      ],
      "event_url": {
        "url": "https://www.example.com/events/987654-xyz"
      }
    }
  ]
}

이벤트 정의

Proto

// Represents a single event.
message Event {
  // Unique across the feed.
  // Max length: 255. Allowed characters are alphanumeric, _, and -.
  // Required.
  string id = 1
      ;

  // The title of the event in plain text.
  // "und" (undefined) language code should be used as a fallback.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 150.
  // Required.
  LocalizedTextSet title = 2
      ;

  // The description of the event. Limited formatting options are allowed in the
  // HTML format. Supported tags:
  //   * h1-h5
  //   * ul, ol, li
  //   * strong, italic, em
  //   * p, br
  // Other tags are not supported and will be removed. CSS, tables, style
  // property, `a` links are not supported. Images are not allowed, use the
  // related_media field instead.
  // Recommended to not exceed length of 10000 in any language.
  // Max length: 16000.
  // Recommended.
  LocalizedTextSet description = 3
      ;

  // Detailed timing information for the event.
  // Required.
  TimeInfo time_info = 4
      ;

  // The physical location where the event is held.
  // Required.
  Location venue = 5
      ;

  // List of the performing or related entities in the Event. These are meant to
  // reflect the artist/team/group/etc that a person might see on the ticket or
  // broader concepts (e.g. concert tours, festivals).
  // Max number of entities: 100.
  // Strongly recommended.
  repeated Entity related_entities = 6
      ;


  enum EventType {
    // Not specified. Do not use.
    EVENT_TYPE_UNSPECIFIED = 0;
    EVENT_TYPE_CONCERT = 1;
    EVENT_TYPE_SPORTS = 2;
    EVENT_TYPE_THEATER = 3;
    EVENT_TYPE_WORKSHOP = 4;
    EVENT_TYPE_CONVENTION = 5;
    EVENT_TYPE_TOUR = 6;
    EVENT_TYPE_SHOW = 7;
    EVENT_TYPE_FAIR = 8;
    EVENT_TYPE_FESTIVAL = 9;
    EVENT_TYPE_EXPO = 10;
  }

  // A list of event types that best describe the event.
  // Max number of types: 5.
  // Optional.
  repeated EventType event_types = 14
      ;

  // Tickets available for this event.
  // Max number of tickets: 20.
  // Required.
  repeated Ticket tickets = 8
      ;

  // Related media such as photos or videos.
  // Max number of media: 30.
  // Recommended.
  repeated Media related_media = 9
      ;

  // Provider brand name. This should be the brand that is owned by the partner.
  // If partner is acting as an aggregator and the brand is not owned by them,
  // they should instead set the ticket's `seller_info` field.
  // "und" (undefined) language code should be used as a fallback.
  // Max length: 50.
  // Optional.
  LocalizedTextSet brand_name = 10
      ;

  // Landing page URL for this event. The page should include a button to start
  // the booking/checkout flow.
  // Do not use link.mobile_url or link.localized_mobile_url.
  // Required.
  DeepLink event_url = 11
      ;

  enum PartnerRole {
    PARTNER_ROLE_UNSPECIFIED = 0;
    PARTNER_ROLE_OFFICIAL_SELLER = 1;
    PARTNER_ROLE_AGGREGATOR = 2;
  }

  // Indicates the role of the partner listing the event tickets.
  // Optional.
  PartnerRole partner_role = 12
      ;

  // Information about the creator of the event. Only relevant for platforms
  // that include user-generated content events.
  message EventCreator {
    // Name of the event creator.
    // Max length: 100.
    // Required.
    string name = 1
        ;
  }

  // Information about the creator of the event. Should be used only for
  // partners that include user-generated content events.
  // Optional
  EventCreator event_creator = 13;

}

예

{
  "id": "123456-abc",
  "title": {
    "localized_texts": [
      {
        "text": "Summer Concert Series",
        "language_code": "en-US"
      },
      {
        "text": "Serie de conciertos de verano",
        "language_code": "es-ES"
      }
    ]
  },
  "description": {
    "localized_texts": [
      {
        "text": "<h1>Summer Concert Series</h1><p>Join us for our annual summer concert series featuring a variety of local artists.</p>",
        "language_code": "en-US"
      }
    ]
  },
  "time_info": {
    "start_seconds": 1695686400,
    "end_seconds": 1695700800,
    "door_open_seconds": 1695684600
  },
  "venue": {
    "id": "example_1",
    "location": {
      "place_info": {
        "name": "A place",
        "structured_address": {
          "country_code": "US",
          "postal_code": "94043",
          "locality": "Mountain View",
          "street_address": "1600 Amphitheatre Pkwy"
        }
      }
    }
  },
  "related_entities": [
    {
      "id": "7890",
      "name": {
        "text": "The Music Band",
        "language_code": "en-US"
      },
      "entity_type": "ENTITY_TYPE_PERFORMER_MUSICIAN",
      "performer_role": "PERFORMER_ROLE_HEADLINER"
    }
  ],
  "event_types": ["EVENT_TYPE_CONCERT"],
  "tickets": [
    {
      "id": "general-admission",
      "title": {
        "localized_texts": [
          {
            "text": "General Admission",
            "language_code": "en-US"
          }
        ]
      },
      "referral_urls": [
        {
          "link": {
            "url": "https://www.example.com/tickets/123456-abc/general-admission",
          },
          "surface": "SURFACE_SEARCH"
        }
      ],
      "price": {
        "price": {
          "currency_code": "USD",
          "units": 25,
          "nanos": 190000000
        }
      },
      "availability_info": {
        "spots_available": 100
      },
      "inventory_type": "INVENTORY_TYPE_PRIMARY",
      "eligibility_restriction": "NONE"
    }
  ],
  "related_media": [
    {
      "url": "https://www.example.com/images/summer-concert-series.jpg",
      "type": "MEDIA_TYPE_PHOTO"
    }
  ],
  "event_url": {
    "url": "https://www.example.com/events/123456-abc",
    "localized_url": {
      "localized_texts": [
        {
          "text": "https://www.example.com/events/123456-abc",
          "language_code": "en-US"
        },
        {
          "text": "https://www.example.com/events/123456-abc",
          "language_code": "es-ES"
        }
      ]
    }
  }
}

구현 참고사항

• 장소 위치: 위치를 제공하려면 다음 속성 중 정확히 하나를 입력해야 합니다. place_id, place_info 또는 business_profile_id 여러 속성을 전송하면 통합이 실패합니다.
• 가격 표시 유형:
  • PRICE_DISPLAY_TYPE_ALL_IN는 티켓 가격에 모든 수수료와 세금이 포함된 경우에 사용해야 합니다. 이 경우 per_ticket_fee 및 per_ticket_tax를 설정하면 안 됩니다.
  • PRICE_DISPLAY_TYPE_BASE는 티켓 가격이 기본 가격이고 수수료와 세금이 별도인 경우에 사용해야 합니다. 이 경우 per_ticket_fee 및 per_ticket_tax를 설정해야 합니다.
  • PriceValue 값은 ALL_IN의 결제 시 최종 가격이지만 BASE의 기본 가격을 나타냅니다.
  • is_free: true를 사용하는 경우 Price Display Type를 PRICE_DISPLAY_TYPE_ALL_IN로 업데이트하는 것이 좋습니다.

항목 정의

Proto

// Reference to one of the performing entities in the Event. These are meant to
// reflect the artist/team/group/etc that a person might see on the ticket or
// broader concepts (e.g. concert tours, festivals).
message Entity {
  // Unique identifier of the entity in the partner's database.
  // Max length: 255. Allowed characters are alphanumeric, _, and -.
  // Recommended.
  string id = 1
      ;

  // The name of the entity in plain text.
  // Recommended to not exceed length of 50.
  // Max length: 150.
  // Required.
  google.type.LocalizedText name = 2
      ;

  // The official website URL of the entity.
  // Max length: 2000.
  // Recommended.
  string official_website_url = 3
      ;

  // Url of the webpage that unambiguously describes the entity.
  // This is the webpage on the partner's website for the entity if any; for
  // other public URLs of the entity, use related_urls.
  // Max length: 2000.
  // Recommended.
  string url = 4
      ;

  // Other urls that might identify the entity.
  // Max length: 2000. Max number of links: 10.
  // Optional.
  repeated string related_urls = 5
      ;

  // ID as used by MusicBrainz.
  // Fixed length: 36. Allowed characters are hexadecimal (0-9, a-f) and -.
  // Optional.
  string musicbrainz_id = 6
      ;

  // The YouTube channel id.
  // If provided may be used as an additional input for entity matching.
  // Channel ids start with characters `UC` followed by a variable number of
  // additional characters. Allowed characters are alphanumeric, _, and -.
  // Optional.
  string youtube_channel_id = 9
      ;

  // The type of the entity.
  enum EntityType {
    // Not specified. Do not use.
    ENTITY_TYPE_UNSPECIFIED = 0;

    // The entity represents the music artist or a band performing at a
    // concert or a show.
    ENTITY_TYPE_PERFORMER_MUSICIAN = 1;
    // The entity represents the comedian artist or group of comedians.
    ENTITY_TYPE_PERFORMER_COMEDIAN = 2;
    // The entity represents the magician artist or group of magicians.
    ENTITY_TYPE_PERFORMER_MAGICIAN = 3;
    // The entity represents the online personality (e.g. youtuber, instagramer,
    // podcaster).
    ENTITY_TYPE_PERFORMER_ONLINE_PERSONALITY = 4;
    // The entity represents a sports player.
    ENTITY_TYPE_PERFORMER_SPORTS_PLAYER = 5;
    // The entity represents a sports team.
    ENTITY_TYPE_PERFORMER_SPORTS_TEAM = 6;

    // The entity represent a show. It can refer to a series of events (e.g.
    // 'The Lion King' at West End) or a larger event where the event belongs to
    // (e.g. 'Coachella').
    ENTITY_TYPE_SHOW = 7;
    // The entity represents a concert tour (e.g. 'The Mathematics Tour' of Ed
    // Sheeran).
    ENTITY_TYPE_CONCERT_TOUR = 8;
    // The entity represents a sports event that this event is part of (e.g.
    // 'Olympics 2024' or 'FIFA World Cup')
    ENTITY_TYPE_SPORTS_TOURNAMENT = 9;
  }

  // The type of the entity.
  // Optional.
  EntityType entity_type = 8
      ;

  // The role of the performer in the event.
  enum PerformerRole {
    // Not specified. Do not use.
    PERFORMER_ROLE_UNSPECIFIED = 0;
    // The performer represents a headliner or leading performer at the event.
    PERFORMER_ROLE_HEADLINER = 1;
    // The performer represents a supporting performer at the event.
    PERFORMER_ROLE_SUPPORTER = 2;
    // The performer represents the home team at the (sports) event. Only
    // applicable when PerformerType is PERFORMER_TYPE_SPORTS_TEAM.
    PERFORMER_ROLE_HOME_TEAM = 3;
    // The performer represents the home team at the (sports) event. Only
    // applicable when PerformerType is PERFORMER_TYPE_SPORTS_TEAM.
    PERFORMER_ROLE_AWAY_TEAM = 4;
  }

  // The role of the performer in the event. Should be used only when the entity
  // refers to a person or a group of people (i.e. entity type starts with
  // "ENTITY_TYPE_PERFORMER_*").
  // Optional.
  PerformerRole performer_role = 7
      ;
}

예

{
  "id": "7890",
  "name": {
    "text": "The Music Band",
    "language_code": "en-US"
  },
  "entity_type": "ENTITY_TYPE_PERFORMER_MUSICIAN",
  "performer_role": "PERFORMER_ROLE_HEADLINER"
}

티켓 정의

Proto

// Ticket available for the Event.
message Ticket {
  // Ticket ID. Must be unique within the event.
  // Max length: 255. Allowed characters are alphanumeric, _, and -.
  // Required.
  string id = 1
      ;

  // The title of the ticket in plain text, e.g. "Category 1 ticket".
  //
  // If there is only a single ticket, the ticket title may be the same as the
  // event title. If multiple tickets are present, the title must be
  // unique to the ticket.
  // Recommended to not exceed length of 50 in any language.
  // Max length: 150.
  // Recommended.
  LocalizedTextSet title = 2
      ;

  // The description of the ticket. Limited formatting options are allowed in
  // the HTML format, see event description field for more details.
  // Recommended to not exceed length of 10000 in any language.
  // Max length: 16000.
  // Recommended.
  LocalizedTextSet description = 3
      ;

  // Additional information about the seller of this ticket. In certain cases
  // the seller may differ from the provider of the event (e.g. in cases of
  // aggregators providing tickets for sellers they have aggregated).
  // Optional.
  SellerInfo seller_info = 9;

  // URL for this ticket. The page should include a button to start the
  // booking/checkout flow.
  // Required.
  repeated ReferralLink referral_urls = 4
      ;

  // Lowest base adult general-accessible ticket price.
  // Recommended.
  Price price = 5;

  // Information about the availability of the ticket.
  // Recommended.
  AvailabilityInfo availability_info = 6;

  // Cancellation policy for this ticket.
  // Optional.
  CancellationPolicy cancellation_policy = 7;

  // Predetermined inventory type of a single ticket of this type.
  enum InventoryType {
    // The inventory type is unspecified.
    INVENTORY_TYPE_UNSPECIFIED = 0;
    // Primary inventory.
    INVENTORY_TYPE_PRIMARY = 1;
    // Verified resale inventory.
    INVENTORY_TYPE_VERIFIED_RESALE = 2;
    // Resale inventory.
    INVENTORY_TYPE_RESALE = 3;
    // Aggregator inventory.
    INVENTORY_TYPE_AGGREGATOR = 4;
    // Presale inventory. Currently being used by YouTube only.
    INVENTORY_TYPE_PRESALE = 5;
  }

  // Predetermined inventory type of a single ticket of this type.
  // Optional.
  InventoryType inventory_type = 8
      ;

  // Additional info about a presale ticket (i.e. presale code). Currently
  // being used by YouTube only to indicate presale tickets. Optional.
  PresaleInfo presale_info = 10;

  // Indicates whether the ticket rate has eligibility restrictions.
  enum EligibilityRestriction {
    // Default value. It is unknown whether there are any eligibility
    // restrictions.
    UNKNOWN = 0;

    // The ticket has no eligibility restrictions.
    NONE = 1;

    // The ticket is only eligible for children.
    CHILD = 2;

    // The ticket has eligibility restrictions that are unknown or do not map
    // to another enumerated value.
    OTHER = 3;
  }

  // Indicates whether this ticket has eligibility restrictions (e.g.,
  // child-only or other restricted rates vs. general admission). Optional.
  EligibilityRestriction eligibility_restriction = 11;
}

예

{
  "id": "general-admission",
  "title": {
    "localized_texts": [
      {
        "text": "General Admission",
        "language_code": "en-US"
      }
    ]
  },
  "referral_urls": [{
    "link": {
      "url": "https://www.example.com/tickets/123456-abc/general-admission",
    },
    "surface": "SURFACE_SEARCH"
  }],
  "price": {
    "price": {
      "currency_code": "USD",
      "units": 25,
      "nanos": 190000000
    }
  },
  "availability_info": {
    "spots_available": 100
  },
  "inventory_type": "INVENTORY_TYPE_PRIMARY",
  "eligibility_restriction": "NONE"
}

SellerInfo 정의

Proto

// Additional information about the seller of a ticket.
message SellerInfo {
  // The name of the ticket seller. This may differ from the name of the event
  // provider in certain cases, e.g. aggregators providing tickets for sellers
  // that they have aggregated.
  // Max length: 150.
  // Optional.
  LocalizedTextSet name = 1
      ;

예

{
  "name": {
    "localized_texts": [
      {
        "text": "Example Seller",
        "language_code": "en-US"
      }
    ]
  },
  "logo_url": "https://www.example.com/images/fav-icon.png"
}

PresaleInfo 정의

Proto

// Additional info about a presale ticket. Currently being used by YouTube
// only.
message PresaleInfo {
  // Optional presale code that can be used to purchase the ticket. Presale
  // code is not required for presale tickets, and only the inventory type
  // INVENTORY_TYPE_PRESALE should be used to determine if the ticket is
  // presale.
  string presale_code = 1;
}

예

{
  "presale_code": "PRESALE123"
}

ReferralLink 정의

Proto

// Referral link.
message ReferralLink {
  // Landing page URL. The page should include a button to start the
  // booking/checkout flow.
  // Do not use link.mobile_url or link.localized_mobile_url.
  // Required.
  DeepLink link = 1
      ;

  // Predetermined event surface associated with a action link.
  enum Surface {
    // The surface is unspecified.
    SURFACE_UNSPECIFIED = 0;
    // The action link is booking a event ticket in Search.
    SURFACE_SEARCH = 1;
    // The action link is booking a event ticket in YouTube.
    SURFACE_YOUTUBE = 2;
    // The action link is clicking on an ad for the event.
    SURFACE_ADS = 3;
  }

  // Predetermined event surface associated with a link.
  // Optional.
  Surface surface = 2;
}

예

{
  "link": {
    "url": "https://www.example.com/tickets/123456-abc/general-admission",
  },
  "surface": "SURFACE_SEARCH"
}

가격 정의

Proto

// Information about the price.
message Price {
  // Price value, must match the final price on the checkout page. Currency will
  // be converted to the user currency on rendering.
  // Required when is_free is false.
  google.type.Money value = 1
      ;

  // Admission or ticket is free. Must be set to true for zero-price options.
  // Optional, default is false.
  bool is_free = 2;

  // Booking fees included in the final price.
  // Optional.
  google.type.Money per_ticket_fee = 3
      ;

  // Taxes included in the final price.
  // Optional.
  google.type.Money per_ticket_tax = 4
      ;

  // Indicates the price format displayed on the landing page.
  //
  // This field allows Google surfaces to show the same price format as used by
  // the landing page. Consistent price formats improve conversion rate and
  // reduce confusion.
  enum PriceDisplayType {
    // The price display type is unspecified. Google will determine which
    // format to show.
    PRICE_DISPLAY_TYPE_UNSPECIFIED = 0;
    // The price shown on the landing page is the base price.
    PRICE_DISPLAY_TYPE_BASE = 1;
    // The price shown on the landing page includes all fees and taxes.
    PRICE_DISPLAY_TYPE_ALL_IN = 2;
  }

  // Predetermined display type of a single option price.
  PriceDisplayType price_display_type = 5;
}

예

// price with fees and taxes and landing page is showing base price with fees separate
{
  "value": {
    "currency_code": "USD",
    "units": 25,
    "nanos": 190000000
  },
  "per_ticket_fee": {
    "currency_code": "USD",
    "units": 5,
    "nanos": 990000000
  },
  "per_ticket_tax": {
    "currency_code": "USD",
    "units": 1,
    "nanos": 750000000
  },
  "price_display_type": "PRICE_DISPLAY_TYPE_BASE"
}

// price including fees and taxes as all in price
{
  "value": {
    "currency_code": "USD",
    "units": 25,
    "nanos": 190000000
  },
  "per_ticket_fee": {
    "currency_code": "USD",
    "units": 0
  },
  "per_ticket_tax": {
    "currency_code": "USD",
    "units": 0
  },
  "price_display_type": "PRICE_DISPLAY_TYPE_ALL_IN"
}

// Free ticket
{
  is_free: true
}

LocalizedTextSet 정의

Proto

// Values of the localized fields.
message LocalizedTextSet {
  // Per-locale LocalizedText values.
  // Maximum repeatedness: 50
  // At least one value is required
  // "und" (undefined) language code should be used as a fallback.
  repeated google.type.LocalizedText localized_texts = 1
      ;
}

예

{
  localized_texts: [{
    "language_code": "en",
    "text": "Sunrise tour"
  }]
}

TimeInfo 정의

Proto

// Time information about a time slot for a service or event.
message TimeInfo {
  // Event start time - seconds since epoch UTC.
  // Required
  int64 start_seconds =
      1
      ;

  // Set to true if the start sec has not been decided.
  // The start_sec in this case must be set to the earliest potential time.
  bool start_to_be_decided = 2;

  // Event end time - seconds since epoch UTC.
  // If provided must be not earlier than start_seconds.
  // Optional.
  int64 end_seconds =
      3
      ;

  // Door opening time -in seconds since the epoch UTC.
  // If provided must be not later than start_seconds.
  // Optional.
  int64 door_open_seconds =
      4
      ;
}

예

{
  "start_seconds": 1695686400,
  "end_seconds": 1695700800,
  "door_open_seconds": 1695684600
}

미디어 정의

Proto

message Media {
  // URL of this media source. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  // Required.
  string url = 1
      ;

  enum MediaType {
    // Don't use, for backwards compatibility only.
    MEDIA_TYPE_UNSPECIFIED = 0;
    // Indicates the media provided by the url is a photo.
    MEDIA_TYPE_PHOTO = 1;
  }
  // Type of this media source.
  // Required.
  MediaType type = 2
      ;

  // Attribution information about the source of the media. Note that if
  // the attribution is required to display with the media to give credit to
  // photographer or agency, this field must be set.
  // Recommended to not exceed length of 1000 in any language.
  // Max length: 2000.
  // Optional.
  LocalizedTextSet attribution = 3
      ;
}

예

{
    "url": "http://www.test.com/photo2.jpg",
    "type": "MEDIA_TYPE_PHOTO",
    "attribution": {
        "localized_texts": [
            {
                "language_code": "en",
                "text": "Test Event Photo"
            }
        ]
    }
}

딥 링크 정의

Proto

// Deep link definition. Can include value parameters that will be expanded on
// serve time.
message DeepLink {
  // Landing page URL template for desktop. If both `url` and `localized_url`
  // are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Either `url` or `localized_url` is required.
  string url = 1
      ;


  // Localized landing page URL template for desktop. If both `url` and
  // `localized_url` are provided, the former is used as a fallback in case
  // no URL matches the user’s locale.
  // Max length: 2000.
  // Max number of locales: 50.
  // Either `url` or `localized_url` is required.
  LocalizedTextSet localized_url = 3
      ;

}

예

// Example 1: single landing page URL.
{
  "url": "https://www.test.com/test-event/"
}

// Example 2: localized landing page URL with fallback
{
  "url": "https://www.test.com/test-event/"
  "localized_url": {
    "localized_texts": [{
          "language_code": "de",
          "text": "https://www.test.com.de/test-event/"
    }, {
          "language_code": "es-MX",
          "text": "https://www.test.com.mx/test-event/"
    }, {
          "language_code": "zh-HK",
          "text": "https://www.test.com.cn/test-event/"
    }]
  }
}

AvailabilityInfo 정의

Proto

// Availability information of a time slot or ticket for a service or event.
message AvailabilityInfo {
  // On sale start time - seconds since epoch UTC
  // Optional.
  int64 onsale_start_seconds = 1 [(googlesql.format) = TIMESTAMP_SECONDS];

  // On sale end time - seconds since epoch UTC
  // Optional.
  int64 onsale_end_seconds = 2 [(googlesql.format) = TIMESTAMP_SECONDS];

  // The total number of tickets (or spots) that were originally available for
  // this availability.
  // Optional.
  int32 spots_total = 3;

  // The current number of tickets (or spots) still available for purchase for
  // this availability.
  // Required.
  int32 spots_available = 4
      ;
}

예

"availability_info": {
  "spots_available": 500
}

CancellationPolicy 정의

Proto

// Cancellation policy for a product.
message CancellationPolicy {
  // Defines a single refund condition. Multiple refund conditions could be
  // used together to describe "refund steps" as various durations before the
  // service start time.
  message RefundCondition {
    // Duration in seconds before the start time, until when the customer can
    // receive a refund for part of the service's cost specified in
    // `refund_percent`.
    // When unset or set to 0 the service can be cancelled at any time.
    // Optional.
    uint32 min_duration_before_start_time_sec = 1;

    // The percent that can be refunded, as long as the service booking is
    // cancelled at least `min_duration_before_start_time` before the service
    // start time, in the range of [0, 100].
    // When unset or set to 0, the service is not refundable. When set to 100
    // this service is fully refundable.
    // Optional.
    uint32 refund_percent = 2
        ;

    // A flat fee deducted on refund. Could be used separately, or in
    // combination with the refund_percent above. In the latter case, refund
    // percent applies first, then the fee is deducted.
    // Optional.
    google.type.Money refund_fee = 3
        ;
  }
  // Zero or more refund conditions applicable to the policy.
  // Max number of refund conditions: 10.
  repeated RefundCondition refund_conditions = 1
      ;
}

예

{
  "refund_conditions": [
  {
    "min_duration_before_start_time_sec": 86400,
    "refund_percent": 100
  }]
}

위치 정의

Proto

message Location {
  // At least one of (location, description) must be set, and we highly
  // recommend populating location wherever possible.
  //
  // To emphasize, both fields can be populated together, e.g. you can set
  // Central Park New York for the location and "In front of the 72 Street
  // Station" for the description.
  GeoLocation location = 1
      ;

  // Additional description in human-readable form, e.g.
  //     "On the left side of the fountain on the Palace square".
  // At least one of (location, description) must be set.
  // Recommended to not exceed length of 1000 in any language. Max length: 2000.
  LocalizedTextSet description = 2
      ;

  // Unique id in the partner database identifying the location.
  // Max length: 255. Allowed characters are alphanumeric, _, and -.
  // Required for Events integration.
  // Optional for Things to do integration.
  string id = 3
      ;
}

예

{
    "id": "venue_id",
    "location": {
        "place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
}

위치정보 정의

Proto

message GeoLocation {
  // Required (exactly one variant from oneof).
  oneof value {

    // Place ID as defined by the Places API:
    //   https://developers.google.com/places/web-service/place-id
    //
    // Uniquely identifies a POI on Google.
    // It can be sourced using the Places API endpoints, for instance Place
    // Search or Place Autocomplete, or manually using the Find Location Matches
    // tool in Things to Do Center.
    // Max length: 64.
    string place_id = 1
        ;

    // Legacy single-line address.
    // Components are expected to be comma-separated, with the first component
    // being the place name as it is displayed on Google.
    // For higher matching accuracy, use the street address shown on Google for
    // the place.
    //
    // Examples:
    // - "Colosseum, Piazza del Colosseo, 1, 00184 Roma RM, Italy"
    // - "The British Museum, Great Russell St, London WC1B 3DG, United Kingdom"
    // Max length: 200.
    //
    // Deprecated: use `place_info` for higher matching accuracy, which provides
    // a separate field for the place name and supports both structured and
    // unstructured address formats.
    string address = 3 [
      deprecated = true
    ];

    // Structured place information.
    PlaceInfo place_info = 4;

    // Business Profile ID, as found in the Google Business Profile settings
    // page. Use this field when sourcing locations directly from the place
    // owner, who has access to the Google Business Profile for the place and
    // can provide such ID.
    uint64 business_profile_id = 5
        ;

    // Geographic coordinates.
    // This field can only be used to determine a city or geographical region,
    // as it is too ambiguous to identify a specific place or businesses.
    // Use `place_info` instead to match to a specific place by name and
    // coordinates.
    google.type.LatLng lat_lng = 2
        ;
  }
}

예

"place_id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"

"place_info": {
  "name": "Eiffel Tower",
  "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
}

"business_profile_id": 11458995034835395294

"lat_lng": {
  "latitude": -25.3511774,
  "longitude": 131.0326859
}

PlaceInfo 정의

Proto

message PlaceInfo {
  // Place or business name.
  // For higher matching accuracy, this should be the same as the name shown on
  // Google for the place. For places with a claimed Google Business Profile,
  // this should be the same as the business name configured in the business
  // profile.
  // Max length: 100.
  // Required.
  string name = 1
      ;

  // Phone number, including the international prefix.
  // For higher matching accuracy, this should be the same as the phone number
  // shown on Google for the place.
  // It can include commonly used separator characters.
  // Examples: "[phone]", "[phone]".
  // Max length: 30.
  // Optional.
  string phone_number = 2
      ;

  // Website URL shown on Google for the place, preferably the URL linked from
  // the business listing in Google Maps or Search for the place.
  // Max length: 1000.
  // Optional.
  string website_url = 3
      ;

  // Geographic coordinates of the place.
  // If left empty, Google will infer the coordinates from the address.
  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  google.type.LatLng coordinates = 4
      ;

  // Optional, but either `coordinates` or one of `address_type` must be
  // provided.
  oneof address_type {
    // Structured address.
    // Prefer this format whenever possible for higher matching accuracy.
    StructuredAddress structured_address = 5
        ;

    // Unstructured address.
    // It should not include the place or business name, which must instead be
    // provided separately using the `name` field.
    //
    // Examples:
    // - `name`: "Colosseum", `unstructured_address`: "Piazza del Colosseo, 1,
    // 00184 Roma RM, Italy".
    // - `name`: "The British Museum", `unstructured_address`: "Great Russell
    // St, London WC1B 3DG, United Kingdom".
    //
    // Max length: 400.
    string unstructured_address = 6
        ;
  }
}

예

"place_info": {
  "name": "Colosseum",
  "phone_number": "[phone]",
  "website_url": "https://colosseo.it/",
  "coordinates": {
    "latitude": 41.8902102,
    "longitude": 12.4922309
  },
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

"place_info": {
  "name": "Eiffel Tower",
  "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
}

"place_info": {
  "name": "Mutitjulu Waterhole",
  "coordinates": {
    "latitude": -25.3511774,
    "longitude": 131.0326859
  }
}

StructuredAddress 정의

Proto

message StructuredAddress {
  // Street address, including house number and any other component that cannot
  // be provided using the more specific fields defined below. It should not
  // include the place or business name, which must instead be provided
  // separately using the `name` field under `PlaceInfo`. It should also not
  // include postal code, locality or country as those should be provided using
  // the corresponding fields below.
  //
  // Examples:
  // - "Piazza del Colosseo, 1" for the Colosseum.
  // - "Great Russell St" for The British Museum.
  // - "Champ de Mars, 5 Av. Anatole France" for the Eiffel Tower.
  //
  // Max length: 200.
  // Required.
  string street_address = 1
      ;

  // Locality, generally referring to the city/town portion of an address.
  // Examples: "New York", "Rome", "London", "Tokyo".
  // In regions of the world where localities are not well defined or do not fit
  // into this structure well, leave empty.
  // Max length: 80.
  // Optional.
  string locality = 2
      ;

  // Highest administrative subdivision used for postal addresses of the
  // specific country or region. This can be a state, a region, a province, an
  // oblast, a prefecture, etc.
  // It can be an abbreviation or a full name, depending on how the region is
  // usually represented in the postal addresses of the specific country. For
  // example, "CA" or "California" for US addresses, "RM" for Rome province in
  // Italy.
  // Many countries don't use an administrative area in postal addresses. For
  // instance, this field should not be used for addresses in Switzerland.
  // Max length: 80.
  // Optional.
  string administrative_area = 3
      ;

  // The postal code or zip code.
  // Examples: "75007", "WC1B 3DG", etc.
  // Required if the country supports postal codes, otherwise it should be left
  // empty.
  // Max length: 30.
  // Optional.
  string postal_code = 4
      ;

  // Country code, as defined by Unicode's "CLDR", itself based on the ISO 3166
  // alpha-2 standard. See
  // https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.
  //
  // Examples: "US" for the United States, "FR" for France, "GB" for the United
  // Kingdom, etc.
  // Max length: 2.
  // Required.
  string country_code = 5
      ;
}

예

{
  "structured_address" {
    "street_address": "Piazza del Colosseo, 1",
    "locality": "Roma",
    "administrative_area": "RM",
    "postal_code": "00184",
    "country_code": "IT"
  }
}

google.type.Money 정의

Proto

// Represents an amount of money with its currency type.
message google.type.Money {
  // The three-letter currency code defined in ISO 4217.
  string currency_code = 1;

  // The whole units of the amount.
  // For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
  int64 units = 2;

  // Number of nano (10^-9) units of the amount.
  // The value must be between -999,999,999 and +999,999,999 inclusive.
  // If `units` is positive, `nanos` must be positive or zero.
  // If `units` is zero, `nanos` can be positive, zero, or negative.
  // If `units` is negative, `nanos` must be negative or zero.
  // For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  int32 nanos = 3;
}

예

// represents EUR: 20.75
{
  "currency_code": "EUR",
  "units": 20,
  "nanos": 750000000
}

google.type.LatLng 정의

Proto

// An object that represents a latitude/longitude pair. This is expressed as a
// pair of doubles to represent degrees latitude and degrees longitude. Unless
// specified otherwise, this must conform to the
// <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
// standard</a>. Values must be within normalized ranges.
message google.type.LatLng {
  // The latitude in degrees. It must be in the range [-90.0, +90.0].
  double latitude = 1;

  // The longitude in degrees. It must be in the range [-180.0, +180.0].
  double longitude = 2;
}

예

{
  "latitude": 41.8902102,
  "longitude": 12.4922309
}

google.type.LocalizedText 정의

Proto

message google.type.LocalizedText {
  // Localized string in the language corresponding to `language_code`.
  string text = 1;

  // The text's BCP-47 language code, such as "en-US" or "sr-Latn".
  //
  // For more information, see
  // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
  string language_code = 2;
}

예

{
  "text": "Sample English Text",
  "language_code": "en-US"
}