photo_tag
Description
A photo tag as represented in FQL.
Columns
| Name | Description |
|---|---|
created timestamp | The date that the tag being queried was created (UNIX timestamp) |
object_id | The object ID of the photo being queried. Preferred over pid |
pid | The ID of the photo being queried. The pid cannot be longer than 50 characters. Note: Because the pid is a string, you should always wrap the pid in quotes when referenced in a query |
subject | The ID of the object that is tagged, e.g. user, group, and event. For photos associated with events or groups, use the eid or gid for subject |
text string | The content of the tag being queried. It contains either the name of the user tagged or the text tag |
xcoord float | The center of the tag's horizontal position, measured as a floating-point percentage from 0 to 100, from the left edge of the photo |
ycoord float | The center of the tag's vertical position, measured as a floating-point percentage from 0 to 100, from the top edge of the photo |
Examples
- SELECT ... FROM photo_tag WHERE object_id = A
- SELECT ... FROM photo_tag WHERE pid = A
- SELECT ... FROM photo_tag WHERE subject = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.
Permissions
To read the photo_tag table you need the following permissions:
User:
user_photospermissions to access photo tag information that a user is tagged in.friends_photospermissions to access photo tag information that a friend is tagged in.
Group:
- any valid
access_tokento access photo tags of a public group. user_photospermissions to access photo tags of a user for a non-public group that the current user is a member of.friends_photospermissions to access photo tags of a friend for a non-public group that the current user is a member of.
Event:
- any valid
access_tokento access photo tags of a public event. user_photospermissions to access photo tags of a user for a non-public event that the current user has been invited to. If the invited user removes the event from their list they will no longer be able to read the table.friends_photospermissions to access photo tags of a friend for a non-public event that the current user has been invited to. If the invited user removes the event from their list they will no longer be able to read the table.
Note: You can also use the photo_tag FQL table to query for photos associated with a group (given its gid) or event (given its eid). See below for sample queries on how to do this.