| CARVIEW |
Photo
Represents an individual photo on Facebook.
Reading
This represents a Photo on Facebook.
Permissions
- Any valid access token can read photos on a public Page.
- A page access token can read all photos posted to or posted by that Page.
- The current user's photos can be read if the user has granted the
user_photosoruser_postspermission. - A user access token may read a photo that the current user is tagged in if they have granted the
user_photosoruser_postspermission. However, in some cases the photo's owner's privacy settings may not allow your application to access it. - A User access token for an Admin of a Group can read Group-owned Photos.
- A User access token for an Admin of an Event can read Event-owned Photos if required after April 30, 2018.
New Page Experience
This endpoint is supported for New Page Experience.Feature Permissions
| Name | Description |
|---|---|
| Page Public Content Access | This feature permission may be required. |
Example
GET /v23.0/{photo-id} HTTP/1.1
Host: graph.facebook.com/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->get(
'/{photo-id}',
'{access-token}'
);
} catch(Facebook\Exceptions\FacebookResponseException $e) {
echo 'Graph returned an error: ' . $e->getMessage();
exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
echo 'Facebook SDK returned an error: ' . $e->getMessage();
exit;
}
$graphNode = $response->getGraphNode();
/* handle the result *//* make the API call */
FB.api(
"/{photo-id}",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{photo-id}",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{photo-id}"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];Parameters
This endpoint doesn't have any parameters.Fields
| Field | Description |
|---|---|
idnumeric string | The photo ID |
alt_textstring | Accessible alternative description for an image |
alt_text_customstring | User provided accessible alternative description for an image |
backdated_timedatetime | A user-specified time for when this object was created |
backdated_time_granularityenum | How accurate the backdated time is |
can_backdatebool | Indicates whether the viewer can backdate the photo |
can_deletebool | Indicates whether the viewer can delete the photo |
can_tagbool | Indicates whether the viewer can tag the photo |
created_timedatetime | The time this photo was published |
If this object has a place, the event associated with the place | |
fromUser|Page | The profile (user or page) that uploaded this photo |
heightunsigned int32 | The height of this photo in pixels |
iconstring | The icon that Facebook displays when photos are published to News Feed |
images | The different stored representations of the photo. Can vary in number based upon the size of the original photo. |
linkstring | A link to the photo on Facebook |
namestring | The user-provided caption given to this photo. Corresponds to |
name_tags | An array containing an array of objects mentioned in the name field which contain the id, name, and type of each object as well as the offset and length which can be used to match it up with its corresponding string in the name field |
page_story_idstring | ID of the page story this corresponds to. May not be on all photos. Applies only to published photos |
place | Place info |
positionunsigned int32 | Deprecated. Returns 0 Deprecated |
sourcestring | Deprecated. Use Deprecated |
target | The target this photo is published to |
updated_timedatetime | The last time the photo was updated |
webp_images | The different stored representations of the photo in webp format. Can vary in number based upon the size of the original photo. |
widthunsigned int32 | The width of this photo in pixels |
Edges
| Edge | Description |
|---|---|
Edge<InsightsResult> | Insights data |
Edge<Profile> | People who like this |
Edge<ProfilePictureSource> | Link to the 100px wide representation of this photo |
Edge<Page> | Sponsor pages tagged in the photo. |
Error Codes
| Error | Description |
|---|---|
| 100 | Invalid parameter |
| 80001 | There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
| 200 | Permissions error |
| 368 | The action attempted has been deemed abusive or is otherwise disallowed |
| 190 | Invalid OAuth 2.0 Access Token |
| 104 | Incorrect signature |
| 2500 | Error parsing graph query |
| 459 | The session is invalid because the user has been checkpointed |
| 3001 | Invalid query |
Creating
Animated photos are not supported, and a photo must be less than 10MB in size.
Note: the post_id value is not returned for photos added to Albums.
photos edge from the following paths: Parameters
| Parameter | Description |
|---|---|
aidstring | Legacy album ID. Deprecated |
allow_spherical_photoboolean | Default value: falseIndicates that we should allow this photo to be treated as a spherical photo. This will not change the behavior unless the server is able to interpret the photo as spherical, such as via Photosphere XMP metadata. Regular non-spherical photos will still be treated as regular photos even if this parameter is true. |
alt_text_customstring | Accessible alternative description for an image |
android_key_hashstring | Android key hash |
application_idnon-empty string | iTunes App ID. This is used by the native Share dialog that's part of iOS |
attemptint64 | Default value: 0Number of attempts that have been made to upload this photo |
audience_expboolean | Default value: falseAudience exp |
backdated_timedatetime/timestamp | A user-specified creation time for this photo |
backdated_time_granularityenum{year, month, day, hour, min, none} | Default value: noneUse only the part of the |
captionstring | The description of the photo |
composer_session_idstring | Composer session ID |
direct_share_statusint64 | The status to allow sponsor directly boost the post. |
feed_targetingfeed target | Object that controls News Feed targeting for this post. Anyone in these groups will be more likely to see this post. People not in these groups will be less likely to see this post, but may still see it anyway. Any of the targeting fields shown here can be used, but none are required. |
geo_locationsObject | |
countrieslist<string> | |
regionslist<Object> | |
keyint64 | |
citieslist<Object> | |
keyint64 | |
zipslist<Object> | |
keystring | |
localeslist<string> | Values for targeted locales. Use |
age_minint64 | Must be |
age_maxint64 | Maximum age. |
genderslist<int64> | Target specific genders. |
college_yearslist<int64> | Array of integers. Represent graduation years from college. |
education_statuseslist<int64> | Array of integers which represent current educational status. Use |
interested_inlist<int64> | Deprecated. Please see the Graph API Changelog for more information. Deprecated |
relationship_statuseslist<int64> | Array of integers for targeting based on relationship status. Use |
interestslist<int64> | One or more IDs of pages to target fans of pages.Use |
filter_typeint64 | Default value: -1Unused? |
full_res_is_coming_laterboolean | Default value: falseFull res is coming later |
initial_view_heading_override_degreesint64 | Manually specify the initial view heading in degrees from 0 to 360. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
initial_view_pitch_override_degreesint64 | Manually specify the initial view pitch in degrees from -90 to 90. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
initial_view_vertical_fov_override_degreesint64 | Manually specify the initial view vertical FOV in degrees from 60 to 120. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
ios_bundle_idstring | iOS Bundle ID |
is_explicit_locationboolean | Is this an explicit location? |
is_explicit_placeboolean | If set to |
manual_privacyboolean | Default value: falseManual privacy |
messagestring | Deprecated. Please use the caption param instead. |
namestring | Deprecated. Please use the caption param instead. |
no_storyboolean | If set to |
offline_idint64 | Default value: 0Offline ID |
og_action_type_idnumeric string | The Open Graph action type |
og_icon_idnumeric string | The Open Graph icon |
og_object_idOG object ID or URL string | The Open Graph object ID |
og_phrasestring | The Open Graph phrase |
og_set_profile_badgeboolean | Default value: falseFlag to set if the post should create a profile badge |
og_suggestion_mechanismstring | The Open Graph suggestion |
placeplace tag | Page ID of a place associated with the photo |
privacyPrivacy Parameter | Determines the privacy settings of the photo. If not supplied, this defaults to the privacy level granted to the app in the Login dialog. This field cannot be used to set a more open privacy setting than the one granted |
profile_idint | Deprecated. Use Deprecated |
provenance_infoJSON object | provenance_info |
is_gen_aiboolean | is_gen_ai Required |
provenance_typeenum {C2PA, IPTC, EXPLICIT, INVISIBLE_WATERMARK, C2PA_METADATA_EDITED, IPTC_METADATA_EDITED, EXPLICIT_IMAGINE, EXPLICIT_IMAGINE_ME, EXPLICIT_RESTYLE} | provenance_type Required |
sourcestring | source |
proxied_app_idnumeric string or integer | Proxied app ID |
publishedboolean | Default value: trueSet to |
qnstring | Photos waterfall ID |
spherical_metadataJSON object | A set of params describing an uploaded spherical photo. This field is not required; if it is not present we will try to generate spherical metadata from the metadata embedded in the image. If it is present, it takes precedence over any embedded metadata. Please click to the left to expand this list and see more information on each parameter. See also the Google Photo Sphere spec for more info on the meaning of the params: https://developers.google.com/streetview/spherical-metadata |
ProjectionTypestring | Accepted values include equirectangular (full spherical photo), cylindrical (panorama), and cubestrip (also known as cubemap, e.g. for synthetic or rendered content; stacked vertically with 6 faces). Required |
CroppedAreaImageWidthPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: Very similar to equirectangular. This value should be equal to the actual width of the image, and together with FullPanoWidthPixels, it describes the horizontal FOV of content of the image: HorizontalFOV = 360 * CroppedAreaImageWidthPixels / FullPanoWidthPixels. --- In cubestrip projection: This has no relationship to the pixel dimensions of the image. It is simply a representation of the horizontal FOV of the content of the image. HorizontalFOV = CroppedAreaImageWidthPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. Required |
CroppedAreaImageHeightPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value will NOT be equal to the actual height of the image. Instead, together with FullPanoHeightPixels, it describes the vertical FOV of the image: VerticalFOV = 180 * CroppedAreaImageHeightPixels / FullPanoHeightPixels. In other words, this value is equal to the CroppedAreaImageHeightPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. --- In cubestrip projection: This has no relationship to the pixel dimensions of the image. It is simply a representation of the vertical FOV of the content of the image. VerticalFOV = CroppedAreaImageHeightPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. Required |
FullPanoWidthPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: Very similar to equirectangular. This value defines a ratio of horizontal pixels to degrees in the space of the image, and in general the pixel to degree ratio in the scope of the metadata object. Concretely, PixelsPerDegree = FullPanoWidthPixels / 360. This is also equivalent to the circumference of the cylinder used to model this projection. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It only defines the pixel to degree ratio in the scope of the metadata object. It represents the number of pixels in 360 degrees, so pixels per degree is then given by: PixelsPerDegree = FullPanoWidthPixels / 360. As an example, if FullPanoWidthPixels were chosen to be 3600, we would have PixelsPerDegree = 3600 / 360 = 10. An image with a vertical field of view of 65 degrees would then have a CroppedAreaImageHeightPixels value of 65 * 10 = 650. Required |
FullPanoHeightPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the FullPanoHeightPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is always equal to FullPanoWidthPixels / 2. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is a second, redundant representation of PixelsPerDegree. FullPanoHeightPixels = 180 * PixelsPerDegree. It must be consistent with FullPanoWidthPixels: FullPanoHeightPixels = FullPanoWidthPixels / 2. Required |
CroppedAreaLeftPixelsint64 | Default value: 0--- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the CroppedAreaLeftPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. Concretely, AngularOffsetFromLeftDegrees = CroppedAreaLeftPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. AngularOffsetFromLeftDegrees = CroppedAreaLeftPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. |
CroppedAreaTopPixelsint64 | Default value: 0--- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the CroppedAreaTopPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. Concretely, AngularOffsetFromTopDegrees = CroppedAreaTopPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. AngularOffsetFromTopDegrees = CroppedAreaTopPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. |
PoseHeadingDegreesfloat | |
PosePitchDegreesfloat | |
PoseRollDegreesfloat | |
InitialViewHeadingDegreesfloat | |
InitialViewPitchDegreesfloat | |
InitialViewRollDegreesfloat | This is not currently supported |
InitialViewVerticalFOVDegreesfloat | This is deprecated. Please use InitialVerticalFOVDegrees. |
InitialVerticalFOVDegreesfloat | You can set the intial vertical FOV of the image. You can set either this field or InitialHorizontalFOVDegrees. |
InitialHorizontalFOVDegreesfloat | You can set the intial horizontal FOV of the image. You can set either this field or InitialVerticalFOVDegrees. |
PreProcessCropLeftPixelsint64 | |
PreProcessCropRightPixelsint64 | |
sponsor_idnumeric string or integer | Facebook Page id that is tagged as sponsor in the photo post |
sponsor_relationshipint64 | Sponsor Relationship, such as Presented By or Paid PartnershipWith |
tagslist<Object> | Tags on this photo |
xfloat | The x-axis offset for the tag |
yfloat | The y-axis offset for the tag |
tag_uidint | The user_id of the tagged person |
tag_textstring | Text associated with the tag |
target_idint | Don't use this. Specifying a |
targetingtarget | Allows you to target posts to specific audiences. Applies to Pages only |
geo_locationsObject | |
countrieslist<string> | |
regionslist<Object> | |
keyint64 | |
citieslist<Object> | |
keyint64 | |
zipslist<Object> | |
keystring | |
localeslist<string> | |
list<string> | |
list<int64> | |
list<int64> | |
list<string> | |
list<int64> | |
age_minenum {13, 15, 18, 21, 25} | |
time_since_original_postint64 | Same as |
uidint | Deprecated |
unpublished_content_typeenum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | Content type of the unpublished content type |
urlstring | The URL of a photo that is already uploaded to the Internet. You must specify this or a file attachment |
user_selected_tagsboolean | Default value: falseUser selected tags |
vault_image_idnumeric string or integer | A vault image ID to use for a photo. You can use only one of |
Return Type
id in the return type.id: numeric string, post_id: token with structure: Post ID, Error Codes
| Error | Description |
|---|---|
| 321 | Album is full |
| 190 | Invalid OAuth 2.0 Access Token |
| 368 | The action attempted has been deemed abusive or is otherwise disallowed |
| 200 | Permissions error |
| 100 | Invalid parameter |
| 324 | Missing or invalid image file |
| 220 | Album or albums not visible |
photos edge from the following paths: Parameters
| Parameter | Description |
|---|---|
aidstring | Legacy album ID. Deprecated |
allow_spherical_photoboolean | Default value: falseIndicates that we should allow this photo to be treated as a spherical photo. This will not change the behavior unless the server is able to interpret the photo as spherical, such as via Photosphere XMP metadata. Regular non-spherical photos will still be treated as regular photos even if this parameter is true. |
alt_text_customstring | Accessible alternative description for an image |
android_key_hashstring | Android key hash |
application_idnon-empty string | iTunes App ID. This is used by the native Share dialog that's part of iOS |
attemptint64 | Default value: 0Number of attempts that have been made to upload this photo |
audience_expboolean | Default value: falseAudience exp |
backdated_timedatetime | A user-specified creation time for this photo |
backdated_time_granularityenum{year, month, day, hour, min, none} | Default value: noneUse only the part of the |
captionUTF-8 string | The description of the photo Supports Emoji |
composer_session_idstring | Composer session ID |
direct_share_statusint64 | The status to allow sponsor directly boost the post. |
feed_targetingfeed target | Object that controls News Feed targeting for this post. Anyone in these groups will be more likely to see this post. People not in these groups will be less likely to see this post, but may still see it anyway. Any of the targeting fields shown here can be used, but none are required. |
geo_locationsObject | |
countrieslist<string> | |
regionslist<Object> | |
keyint64 | |
citieslist<Object> | |
keyint64 | |
zipslist<Object> | |
keystring | |
localeslist<string> | Values for targeted locales. Use |
age_minint64 | Must be |
age_maxint64 | Maximum age. |
genderslist<int64> | Target specific genders. |
college_yearslist<int64> | Array of integers. Represent graduation years from college. |
education_statuseslist<int64> | Array of integers which represent current educational status. Use |
interested_inlist<int64> | Deprecated. Please see the Graph API Changelog for more information. Deprecated |
relationship_statuseslist<int64> | Array of integers for targeting based on relationship status. Use |
interestslist<int64> | One or more IDs of pages to target fans of pages.Use |
filter_typeint64 | Default value: -1Unused? |
full_res_is_coming_laterboolean | Default value: falseFull res is coming later |
initial_view_heading_override_degreesint64 | Manually specify the initial view heading in degrees from 0 to 360. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
initial_view_pitch_override_degreesint64 | Manually specify the initial view pitch in degrees from -90 to 90. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
initial_view_vertical_fov_override_degreesint64 | Manually specify the initial view vertical FOV in degrees from 60 to 120. This overrides any value present in the photo embedded metadata or provided in the spherical_metadata parameter |
ios_bundle_idstring | iOS Bundle ID |
is_explicit_locationboolean | Is this an explicit location? |
is_explicit_placeboolean | If set to |
location_source_idnumeric string or integer | ID of a page or a page set that provides location informationto enable Local Extensions |
manual_privacyboolean | Default value: falseManual privacy |
messagestring | Deprecated. Please use the caption param instead. |
namestring | Deprecated. Please use the caption param instead. |
nectar_modulestring | Nectar module. Internal apps only |
no_storyboolean | If set to |
offline_idint64 | Default value: 0Offline ID |
og_action_type_idnumeric string or integer | The Open Graph action type |
og_icon_idnumeric string or integer | The Open Graph icon |
og_object_idOG object ID or URL string | The Open Graph object ID |
og_phrasestring | The Open Graph phrase |
og_set_profile_badgeboolean | Default value: falseFlag to set if the post should create a profile badge |
og_suggestion_mechanismstring | The Open Graph suggestion |
placeplace tag | Page ID of a place associated with the photo |
privacyPrivacy Parameter | Determines the privacy settings of the photo. If not supplied, this defaults to the privacy level granted to the app in the Login dialog. This field cannot be used to set a more open privacy setting than the one granted |
profile_idint | Deprecated. Use Deprecated |
provenance_infoJSON object | provenance_info |
is_gen_aiboolean | is_gen_ai Required |
provenance_typeenum {C2PA, IPTC, EXPLICIT, INVISIBLE_WATERMARK, C2PA_METADATA_EDITED, IPTC_METADATA_EDITED, EXPLICIT_IMAGINE, EXPLICIT_IMAGINE_ME, EXPLICIT_RESTYLE} | provenance_type Required |
sourcestring | source |
proxied_app_idnumeric string or integer | Proxied app ID |
publishedboolean | Default value: trueSet to |
qnstring | Photos waterfall ID |
scheduled_publish_timeint64 | Time at which an unpublished post should be published (Unix timestamp). Applies to Pages only |
spherical_metadataJSON object | A set of params describing an uploaded spherical photo. This field is not required; if it is not present we will try to generate spherical metadata from the metadata embedded in the image. If it is present, it takes precedence over any embedded metadata. Please click to the left to expand this list and see more information on each parameter. See also the Google Photo Sphere spec for more info on the meaning of the params: https://developers.google.com/streetview/spherical-metadata |
ProjectionTypestring | Accepted values include equirectangular (full spherical photo), cylindrical (panorama), and cubestrip (also known as cubemap, e.g. for synthetic or rendered content; stacked vertically with 6 faces). Required |
CroppedAreaImageWidthPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: Very similar to equirectangular. This value should be equal to the actual width of the image, and together with FullPanoWidthPixels, it describes the horizontal FOV of content of the image: HorizontalFOV = 360 * CroppedAreaImageWidthPixels / FullPanoWidthPixels. --- In cubestrip projection: This has no relationship to the pixel dimensions of the image. It is simply a representation of the horizontal FOV of the content of the image. HorizontalFOV = CroppedAreaImageWidthPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. Required |
CroppedAreaImageHeightPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value will NOT be equal to the actual height of the image. Instead, together with FullPanoHeightPixels, it describes the vertical FOV of the image: VerticalFOV = 180 * CroppedAreaImageHeightPixels / FullPanoHeightPixels. In other words, this value is equal to the CroppedAreaImageHeightPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. --- In cubestrip projection: This has no relationship to the pixel dimensions of the image. It is simply a representation of the vertical FOV of the content of the image. VerticalFOV = CroppedAreaImageHeightPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. Required |
FullPanoWidthPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: Very similar to equirectangular. This value defines a ratio of horizontal pixels to degrees in the space of the image, and in general the pixel to degree ratio in the scope of the metadata object. Concretely, PixelsPerDegree = FullPanoWidthPixels / 360. This is also equivalent to the circumference of the cylinder used to model this projection. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It only defines the pixel to degree ratio in the scope of the metadata object. It represents the number of pixels in 360 degrees, so pixels per degree is then given by: PixelsPerDegree = FullPanoWidthPixels / 360. As an example, if FullPanoWidthPixels were chosen to be 3600, we would have PixelsPerDegree = 3600 / 360 = 10. An image with a vertical field of view of 65 degrees would then have a CroppedAreaImageHeightPixels value of 65 * 10 = 650. Required |
FullPanoHeightPixelsint64 | --- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the FullPanoHeightPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is always equal to FullPanoWidthPixels / 2. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is a second, redundant representation of PixelsPerDegree. FullPanoHeightPixels = 180 * PixelsPerDegree. It must be consistent with FullPanoWidthPixels: FullPanoHeightPixels = FullPanoWidthPixels / 2. Required |
CroppedAreaLeftPixelsint64 | Default value: 0--- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the CroppedAreaLeftPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. Concretely, AngularOffsetFromLeftDegrees = CroppedAreaLeftPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. AngularOffsetFromLeftDegrees = CroppedAreaLeftPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. |
CroppedAreaTopPixelsint64 | Default value: 0--- In equirectangular projection: As described in Google Photo Sphere XMP Metadata spec. --- In cylindrical projection: This value is equal to the CroppedAreaTopPixels value that this image would have, if it were projected into equirectangular format while maintaining the same FullPanoWidthPixels. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. Concretely, AngularOffsetFromTopDegrees = CroppedAreaTopPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. --- In cubestrip projection: This value has no relationship to the pixel dimensions of the image. It is just a representation of the same angular offset that it represents in equirectangular projection in the Google Photo Sphere spec. AngularOffsetFromTopDegrees = CroppedAreaTopPixels / PixelsPerDegree, where PixelsPerDegree is defined by FullPanoWidthPixels. |
PoseHeadingDegreesfloat | |
PosePitchDegreesfloat | |
PoseRollDegreesfloat | |
InitialViewHeadingDegreesfloat | |
InitialViewPitchDegreesfloat | |
InitialViewRollDegreesfloat | This is not currently supported |
InitialViewVerticalFOVDegreesfloat | This is deprecated. Please use InitialVerticalFOVDegrees. |
InitialVerticalFOVDegreesfloat | You can set the intial vertical FOV of the image. You can set either this field or InitialHorizontalFOVDegrees. |
InitialHorizontalFOVDegreesfloat | You can set the intial horizontal FOV of the image. You can set either this field or InitialVerticalFOVDegrees. |
PreProcessCropLeftPixelsint64 | |
PreProcessCropRightPixelsint64 | |
sponsor_idnumeric string or integer | Facebook Page id that is tagged as sponsor in the photo post |
sponsor_relationshipint64 | Sponsor Relationship, such as Presented By or Paid PartnershipWith |
tagslist<Object> | Default value: VecTags on this photo |
xfloat | The x-axis offset for the tag |
yfloat | The y-axis offset for the tag |
tag_uidint | The user_id of the tagged person |
tag_textstring | Text associated with the tag |
target_idint | Don't use this. Specifying a |
targetingtarget | Allows you to target posts to specific audiences. Applies to Pages only |
geo_locationsObject | |
countrieslist<string> | |
regionslist<Object> | |
keyint64 | |
citieslist<Object> | |
keyint64 | |
zipslist<Object> | |
keystring | |
localeslist<string> | |
list<string> | |
list<int64> | |
list<int64> | |
list<string> | |
list<int64> | |
age_minenum {13, 15, 18, 21, 25} | |
temporaryboolean | Default value: falseThis is a temporary photo. |
time_since_original_postint64 | Same as |
uidint | Deprecated |
unpublished_content_typeenum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | Content type of the unpublished content type |
urlURL | The URL of a photo that is already uploaded to the Internet. You must specify this or a file attachment |
user_selected_tagsboolean | Default value: falseUser selected tags |
vault_image_idnumeric string or integer | A vault image ID to use for a photo. You can use only one of |
Return Type
id in the return type.id: numeric string, post_id: string, Error Codes
| Error | Description |
|---|---|
| 368 | The action attempted has been deemed abusive or is otherwise disallowed |
| 324 | Missing or invalid image file |
| 190 | Invalid OAuth 2.0 Access Token |
| 200 | Permissions error |
| 100 | Invalid parameter |
| 240 | Desktop applications cannot call this function for other users |
Updating
Deleting
An app can delete any photos it published, or a page-management app can delete a Photo published to a page that the app manages.
Permissions
- To delete a User's photo, a User access token with
publish_actionspermission is required. - To delete a Page's photo a Page access token and
publish_pagespermission is required. - To delete a User's photo on a Page a Page access token is required.
/{photo_id}.Parameters
This endpoint doesn't have any parameters.Return Type
success: bool, Error Codes
| Error | Description |
|---|---|
| 100 | Invalid parameter |
| 190 | Invalid OAuth 2.0 Access Token |
| 200 | Permissions error |
| 368 | The action attempted has been deemed abusive or is otherwise disallowed |