Photo uploads
From Facebook Developers Wiki
Photos can be uploaded by a user using the Facebook API calls photos.createAlbum, photos.upload, and photos.addTag. The first step is determining a destination album for the photos. There are three alternatives an application may provide:
- photos.createAlbum creates a new album.
- photos.getAlbums retrieves existing albums from which to choose.
- A default application album can be used.
photos.upload uploads the actual image data to the destination album. If no album is specified, the default application album will be used. Once a photo has been uploaded, it is considered "pending" and is only visible to the owner. The owner must review pending photos by navigating to the album and selecting photos to approve or reject. Once approved, a photo is no longer pending and becomes a normal part of the album. Photos uploaded by applications with the photo_upload extended permission, however, will be visible immediately.
photos.addTag optionally adds any tagging information the user has specified in an application. For normal applications, tags may only be added to pending photos. Applications with the photo_upload extended permission can add tags to any photo owned by the user.
After an application uploads a batch of photos, it may be helpful to direct the user to the destination album so the pending photos can be reviewed. The aid element returned from photos.upload can be used as the parameter to photos.getAlbums, which will return the appropriate URL in the link field of its response.
