Lincoln on Crossing The Line

 

“Always bear in mind that your own resolution to succeed is more important than any other one thing.”

– Abraham Lincoln (1809–1865)
16th president of the United States

Before he was elected president, Abraham Lincoln had a business go under, lost a local legislative race, three congressional races and two senatorial races, and lost a bid for the vice presidency (and throughout he lost three sons).

Now Lincoln is regarded as one of the most influential figures in American history for his role in saving the Union and freeing the slaves.

Documents List API

 

There are a number of ways to add resources to your Google Documents List using the API. Most commonly, clients need to upload an existing resource, rather than create a new, empty one. Legacy clients may be doing this in an inefficient way. In this post, we’ll walk through why using resumable uploads makes your client more efficient.

The resumable upload process allows your client to send small segments of an upload over time, and confirm that each segment arrived intact. This has a number of advantages.

Resumable uploads have a customizable memory footprint on client systems

Since only one small segment of data is sent to the API at a time, clients can store less data in memory as they send data to the API. For example, consider a client uploading a PDF via a regular, non-resumable upload in a single request. The client might follow these steps:

  1. Open file pointer to PDF
  2. Pass file pointer and PDF to client library
  3. Client library starts request
  4. Client library reads 100,000 bytes and immediately sends 100,000 bytes
  5. Client library repeats until all bytes sent
  6. Client library returns response

But that 100,000 bytes isn’t a customizable value in most client libraries. In some environments, with limited memory, applications need to choose a custom chunk size that is either smaller or larger.

The resumable upload mechanism allows for a custom chunk size. That means that if your application only has 500KB of memory available, you can safely choose a chunk size of 256KB.

Resumable uploads are reliable even though a connection may not be

In the previous example, if any of the bytes fail to transmit, this non-resumable upload fails entirely. This often happens in mobile environments with unreliable connections. Uploading 99% of a file, failing, and restarting the entire upload creates a bad user experience. A better user experience is to resume and upload only the remaining 1%.

Resumable uploads support larger files

Traditional non-resumable uploads via HTTP have size limits depending on both the client and server systems. These limits are not applicable to resumable uploads with reasonable chunk sizes, as individual HTTP requests are sent for each chunk of a file. Since the Documents List API now supports file sizes up to 10GB, this is very important.

Resumable upload support is already in the client libraries for Google Data APIs

The Java, Python, Objective-C, and .NET Google Data API client libraries all include a mechanism by which you can initiate a resumable upload session. Examples of uploading a document with resumable upload using the client libraries is detailed in the documentation. Additionally, the new Documents List API Python client library now uses only the resumable upload mechanism. To use that version, make sure to follow these directions.

Mapping the football searches

Fall means lots of things in the United States: leaves changing colors, apple picking, back to school and…football. This weekend, the National Football League (NFL) starts its season with a bang, with 15 games on Sunday and Monday. College and high school football are already underway and fans all across the country are tuning in, getting excited and rooting for their teams—in person, on television and online. As a Notre Dame alum (class of ‘87), the ups (and the recent downs) of Fighting Irish football are always a big part of my fall weekends. Regardless of your alma mater or hometown team, one thing is certain: American football is a big deal across the United States. Ahead of most of this week’s kickoffs, we thought it would be fun to take a peek at some of the football search trends from around the country.

There’s some debate as to what is more popular: professional (NFL) football or college football. Search queries make it clear that in spite of the [nfl lockout], the pro game and [nfl] is consistently more popular for U.S. searchers than all of [college football].

That doesn’t mean that the college game isn’t extraordinarily popular. Right now, we’re seeing the highest level of search queries for [college football] since 2004. In certain regions, college football appears to be king over even the NFL. The states with the most searches for [college football] are mostly in the southern part of the country, with the notable exception of the rabid fans of the Nebraska Cornhuskers. That’s no wonder—on Saturdays, when the Huskers are playing at home, their Memorial Stadium becomes the third largest “city” in the state.

We can also conduct a little popularity contest among players in college football. The Heisman Trophy, awarded annually to the top college player, is usually correlated to spikes in search query volume. This year, the early favorites for the Heisman are beginning to take shape. Stanford’s quarterback [andrew luck], who opted to play his senior year in college instead of heading to the pros, is out front in terms of searches, but fans should also watch out for Robert Griffin III from the Baylor Bears program. [rg3], as he’s known, had the game of his career in week one and might be the national breakout star of the first few weeks of the season.

Over on the NFL side, it appears that winning the big game has little relation to how often people search for their favorite player. In the past month, the most searched for player in the NFL is [peyton manning] of the Indianapolis Colts, who last won the Super Bowl in 2007. He’s currently sidelined with a neck injury, so his status is likely driving much of the current search queries. Meanwhile, the quarterbacks from the past two Super Bowl winners, [drew brees] from the New Orleans Saints and [aaron rodgers] of the Green Bay Packers, come in behind a player who isn’t even his team’s starter: Denver Broncos QB and former Florida Gators star [tim tebow].

The old saying goes, “on any given Sunday,” meaning that every team has a chance to win each time they hit the field. The adage manifests itself in typically balanced standings that last throughout the season and into the playoffs. But when it comes to search, we’re not quite so fair and balanced. In fact, there’s a clear favorite, and by this measure they really are “America’s Team”: the [dallas cowboys]. In the U.S., the Cowboys lead all other teams in search query volume, followed by the [chicago bears] and the [green bay packers].

No examination of football search trends would be complete without mentioning Fantasy Football. Millions of fans participate in their own drafts and watch their league’s waiver wires as they serve as coach and general manager for their own fantasy team. The enthusiasm is so fevered that, in the U.S. right now, more people are interested in [fantasy football] than President [obama].

Finally, for spectators, football isn’t just about teams and players. It’s also about the game day food. [Tailgating] searches peak every fall as folks turn to the web to discover new recipes and ideas for pre-game parking lot cookouts. The Super Bowl in February really drives gameday recipe searches, but tailgating staples like [guacamole], [wings] and [brats] all rank high in terms of search quantity every fall, with the king of all tailgating recipe-related searches being [dip].

Whether you’re an NFL fan, an NCAA nut or just someone who likes hot wings, here’s to a great season.