Week 3 and 4 API Additions

Week 3 and 4 API Additions

We've fallen into a cadence of doing weekly backend deployments. With each one comes new API additions. Here are the changes for the past two weeks.

Week 3 Additions

  • AVProgramInput has new fields: name, isPrivate
  • AVProgramPatchInput has been added.
  • AVProgram has new fields: isPrivate, name, thumbnail
  • Mutation has new fields: patchAVProgram

Last week's games were provided to you with a few viewing options. You could choose to watch the Skycam feed ("AAF Raw") or the all-22 feed. For some games, you can also watch the network feed. These API additions support that feature. See also Game.avProgramsConnection and Game.defaultAVProgram, which were week 2 additions.

  • GamePlayerEdge has new fields: jerseyNumber

A pain point for us has been the frequency at which players change numbers. Because they change numbers so often, it's useful to be able to know exactly what number each player wore for each game.

  • PlayStatType has new enum values: AIR_YARDS_INCOMPLETE, AIR_YARDS_COMPLETE, PENALTY_YARDS
  • PlayerStats has new fields: airYardsAttempted, airYardsCompleted, airYardsIncomplete, penalties, penaltyYards
  • TeamStats has new fields: penalties, penaltyYards

These additions provide penalty counts and yards for players and teams, and air yards for quarterbacks.

Week 4 Additions

This week, we've made the following changes:

  • GamePlayerEdge has new fields: position

Like jersey numbers, player positions may change from game to game. So we're giving you a way to get a player's position for any particular game. (Note: Some players currently have null game positions, which will be backfilled at some point this week.)

  • OfficialPosition has new enum values: REPLAY_COMMUNICATOR, TECHNICIAN, SUPERVISOR, VIDEO_EVALUATOR, COACH_TO_PLAYER_CUTOFF_OFFICIAL, GAME_CLOCK_OPERATOR, PLAY_CLOCK_OPERATOR

We've been making an effort to keep all of our game official data accurate and complete for each game. The addition of these positions allows us to provide data for more than just the core officiating crew.

  • PersonNameInput has new fields: pronunciation
  • PersonName has new fields: pronunciation

Some players have names with tricky pronunciations. This field is intended to help with that.

  • Query.eventsConnection is now deprecated.

This API was never used, and might never be used. So we're deprecating it for now.

Week 3 and 4 API Additions
Share this