AP Classification Metadata Guide
Total Page:16
File Type:pdf, Size:1020Kb
AP CLASSIFICATION METADATA Reference Guide Revision 2.6 January 17, 2018 AP CLASSIFICATION METADATA 2.6 TABLE OF CONTENTS INTRODUCTION .............................................................. 3 AP Organization ...................................... 10 Description ........................................................ 10 About This Guide ...................................... 3 AP Organization Values .................................... 10 Searching This Guide ................................ 3 AP ATOM Sample ............................................. 10 What’s New ............................................... 3 AP Geography ........................................... 11 Description ........................................................ 11 SUBJECT CLASSIFICATION AUTHORITIES ........... 4 AP Geography Values ....................................... 11 AP Subject ................................................. 4 Available Properties .......................................... 11 Description .......................................................... 4 Location Types and IDs .................................... 11 Top-Level Subject Categories ............................. 4 AP ATOM Sample ............................................. 11 AP Subject Category Values ............................... 4 AP Event ................................................... 11 AP ATOM Samples ............................................. 4 Description ........................................................ 11 Subject Categories and ANPA ............................ 4 AP ATOM Sample for a Planned Event ........... 12 AP Category Code...................................... 4 AP ATOM Sample for a Developing News Event Description .......................................................... 4 (The Latest) ....................................................... 12 AP Category Codes for Text Stories ................... 4 ADDITIONAL CLASSIFICATION METADATA ...... 13 AP ATOM Sample for a Text Story .................... 5 AP Category Codes for Photos and Graphics .... 5 ItemContentType .................................... 13 AP ATOM Sample for a Photo ........................... 5 Description ........................................................ 13 AP Category Codes for Video ............................. 5 ItemContentType Values .................................. 13 AP ATOM Sample for a Video ............................ 6 AP ATOM Sample ............................................. 14 AP Supplemental Category ....................... 6 Fixture ..................................................... 14 Description .......................................................... 6 Description ........................................................ 14 AP Supplemental Categories .............................. 6 AP ATOM Sample ............................................. 14 AP ATOM Sample ............................................... 6 Priority .................................................... 14 Description ........................................................ 14 ENTITY CLASSIFICATION AUTHORITIES .............. 7 AP ATOM Sample ............................................. 14 AP Party .................................................... 7 Description .......................................................... 7 APPENDIX A: AP SUBJECTS AND ANPA .............. 15 Available Properties ............................................ 7 PartyType Values and IDs .................................. 7 Team Values and Codes ..................................... 8 Associated Event Value and Code Examples .... 8 AP ATOM Samples ............................................. 8 AP Company ............................................. 8 Description .......................................................... 8 Available Properties ............................................ 8 Stock Exchange Codes ........................................ 9 Top-Level APIndustry Values and IDs ............ 10 AP ATOM Sample ............................................. 10 January 17, 2018 | © 2018 The Associated Press 2 AP CLASSIFICATION METADATA 2.6 INTRODUCTION ABOUT THIS GUIDE This document is intended as a supplement to the AP WebFeeds Developer’s Guide. It describes the values of AP Classification Metadata tags available in the AP ATOM feeds that are delivered via AP WebFeeds. SEARCHING THIS GUIDE To search this guide, choose Edit → Find in Adobe Acrobat. WHAT’S NEW REV. DESCRIPTION 2.6 Added Arabic service and removed French, German and Swiss text services (no longer provided). Added “AssociatedEvent” and removed “AssociatedState”. Updated “ItemContentType” values: added “InvestigativeEnterprise”; removed “Digest” (now filed as “Advisory”), “History”, “Profile” and “Sidebar”; renamed “Enterprise/Feature” to “Feature”; updated the “Advisory” definition. Added “Point of interest” to Location Types. 2.5 Added "Priority" to the "Additional Classification Metadata" section. 2.4 Stock exchange code and description updates. New Location Types: “Bay,” “Canal,” “Gulf,” “Lake,” “Ocean,” “River,” “Sea,” “Strait.” New “ItemContentType” values: “Digest,” “History,” “List,” “Opinion,” “PhotoGallery.” Removed “ItemContentType” values: “AP Impact” and “Poll/Survey.” 2.3 AP Event authority for Entity Classification; the “Running” value of “ItemContentType. ” 2.2 Added top-level subject category “Living things” and stock exchange codes LTS, MAL and NSE; changed top-level AP Industry values “Business and professional services” to “Professional services,” “Energy” to “Energy industry,” “Materials” to “Materials industry,” “Media and entertainment” to “Media and entertainment industry;” removed the top-level AP Industry value “Agriculture, food and beverage processing" and added new value “Agriculture”; added Location Type “Former nation.” 2.1 Added AP category codes for video. 2.0 Updated the list of stock exchange codes, the numbers of AP Party names and AP companies; revised the descriptions of Associated State and AP Organization. 1.9 Added the mapping of select high-level AP Subject values to ANPA category codes. 1.8 The existing stock exchange code “NSE” is now associated with Nagoya Stock Exchange rather than National Stock Exchange of India, which is now assigned a new code “NSI.” 1.7 AP Party properties: “Associated State” and “Team;” AP Geography property: “Location Type;” stock exchanges: ENX, FRA, JASDAQ and LJU; revised numbers of subject categories and AP Party names. 1.6 Revised AP Company description, new and revised AP company properties (“Instrument” and “Ticker”), a list of stock exchange codes and an updated AP ATOM sample. 1.5 AP Party type: “WORLD_CUP_ATHLETE;” Item Content Types: “Blog,” “Press Release” and “Sports Scores.” Removed values: top-level subject category “Demographic groups” and audio Item Content Type “Text Only.” 1.4 Top-level subject categories: “Arts and entertainment” and “Media” (instead of “Entertainment” and “News Media” respectively). New “ItemContentType” value: “Game Story.” Updated lists of AP Subject category, AP Industry, AP Organization and AP Geography values at the AP Customer Support site. 1.3 AP Party Types: “COMEDIAN” and “TV_PERSONALITY.” AP Organization authority for Entity Classification. Optional latitude and longitude values included in the AP Geography authority for Entity Classification. 1.2 Top-level subject category values: “Demographic groups,” “Events” and “Obituaries.” AP Geography authority for Entity Classification; a hierarchical list of AP Geography values and a list of AP Fixtures at the AP Customer Support site. 1.1 AP Category values for broadcast and international text. Additional classification metadata: “ItemContentType” and “Fixture.” January 17, 2018 3 AP CLASSIFICATION METADATA 2.6 SUBJECT CLASSIFICATION AUTHORITIES AP SUBJECT Description A hierarchical subject taxonomy developed by the AP that contains approximately 4,300 subject categories and is applied to all media types. Terms in the first three levels of the hierarchy are available to all WebFeeds customers. Additional levels are optional values to which your organization may or may not be entitled. For more information, contact AP Customer Support at [email protected] or 877-836-9477. Top-Level Subject Categories VALUE ID (GUID) Arts and entertainment 16cb0ba3e6d24d97ace39f5a1924669a Business c8e409f8858510048872ff2260dd383e Environment and nature 8783d248894710048286ba0a2b2ca13e Events 06a735407cb61004804eba7fa5283c3e General news f25af2d07e4e100484f5df092526b43e Government and politics 86aad5207dac100488ecba7fa5283c3e Health cc7a76087e4e10048482df092526b43e Lifestyle 3e37e4b87df7100483d5df092526b43e Living things 6f072ea8b0064f3584c61e22f08836ee Media c188eb1088be10048dceb097165a0203 Obituaries 30c418e4b7644a9eb54409baf55036d1 Oddities 44811870882f10048079ae2ac3a6923e Science 4bf76cb87df7100483dbdf092526b43e Social affairs 75a42fd87df7100483eedf092526b43e Sports 54df6c687df7100483dedf092526b43e Technology 455ef2b87df7100483d8df092526b43e AP Subject Category Values For a complete list of AP subject category values, refer to the AP WebFeeds section of the AP Customer Support site at http://customersupport.ap.org. AP ATOM Samples <apcm:SubjectClassification Authority="AP Subject" Value="Business" Id="c8e409f8858510048872ff2260dd383e" /> <apcm:SubjectClassification Authority="AP Subject" Value="Earnings reports" Id="11494c9888fc10048d50ba0a2b2ca13e" /> Subject Categories and ANPA For mappings from the select high-level AP Subject values to ANPA codes,