Page

Graph API Version

v2.10

This represents a Facebook Page. The /{page-id} node returns a single page.

Related Guides

Reading

A Facebook page

Permissions

For pages that are published, you need:

An app or user access token to view fields from fully public pages.
A user access token to view fields from restricted pages that this person is able to view (such as those restrict to certain demographics like location or age, or those only viewable by Page admins).
A page access token can also be used to view those restricted fields.
You need to be the admin of root page for child pages in order to read the global_brand_children edge for a page.

For pages that are not published, you need:

To have the admin role for the page
A page access token

Examples

Graph API Explorer

GET /v2.10/{page-id} HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{page-id}'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

Name	Description
`account_linking_token` UTF-8 encoded string	Short lived account linking token (5 mins expiry) to get the PSID for a user-page pair

Fields

Field	Description
`id` numeric string	Page ID. No access token is required to access this field Core
`about` string	Information about the Page
`access_token` string	The access token you can use to act as the Page. Only visible to Page Admins. If your business requires two-factor authentication, and the person hasn't authenticated, this field may not be returned
`ad_campaign` AdCampaign	The Page's currently running promotion campaign
`affiliation` string	Affiliation of this person. Applicable to Pages representing people
`app_id` id	App ID for app-owned Pages and app Pages
`app_links` AppLinks	AppLinks data associated with the Page's URL
`artists_we_like` string	Artists the band likes. Applicable to Bands
`attire` string	Dress code of the business. Applicable to Restaurants or Nightlife. Can be one of Casual, Dressy or Unspecified
`awards` string	The awards information of the film. Applicable to Films
`band_interests` string	Band interests. Applicable to Bands
`band_members` string	Members of the band. Applicable to Bands
`best_page` Page	The best available Page on Facebook for the concept represented by this Page. The best available Page takes into account authenticity and the number of likes
`bio` string	Biography of the band. Applicable to Bands
`birthday` string	Birthday of this person. Applicable to Pages representing people
`booking_agent` string	Booking agent of the band. Applicable to Bands
`built` string	Year vehicle was built. Applicable to Vehicles
`business`	The Business associated with this Page. Visible only with a page access token or a user access token that has admin rights on the page
`can_checkin` bool	Whether this page has checkin functionality enabled
`can_post` bool	Whether the current session user can post on this Page
`category` string	The Page's category. e.g. Product/Service, Computers/Technology Core
`category_list` list<PageCategory>	The Page's sub-categories
`checkins` unsigned int32	Number of checkins at a place represented by a Page Core
`company_overview` string	The company overview. Applicable to Companies
`contact_address` MailingAddress	The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address
`context` OpenGraphContext	Social context for this Page
`country_page_likes` unsigned int32	If this is a Page in a Global Pages hierarchy, the number of people who are being directed to this Page.
`cover` CoverPhoto	Information about the page's cover photo
`culinary_team` string	Culinary team of the business. Applicable to Restaurants or Nightlife
`current_location` string	Current location of the Page
`description` string	The description of the Page Core
`description_html` string	The description of the Page in raw HTML
`directed_by` string	The director of the film. Applicable to Films
`display_subtext` string	Subtext about the Page being viewed
`displayed_message_response_time` string	Page estimated message response time displayed to user
`emails` list<string>	The emails listed in the About section of a Page
`engagement` Engagement	The social sentence and like count information for this Page. This is the same info used for the like button
`fan_count` unsigned int32	The number of users who like the Page. For Global Pages this is the count for all Pages across the brand.
`featured_video` Video	Video featured by the Page
`features` string	Features of the vehicle. Applicable to Vehicles
`food_styles` list<string>	The restaurant's food styles. Applicable to Restaurants
`founded` string	When the company was founded. Applicable to Pages in the Company category
`general_info` string	General information provided by the Page
`general_manager` string	General manager of the business. Applicable to Restaurants or Nightlife
`genre` string	The genre of the film. Applicable to Films
`global_brand_page_name` string	The name of the Page with country codes appended for Global Pages. Only visible to the Page admin
`global_brand_root_id` numeric string	This brand's global Root ID
`has_added_app` bool	Indicates whether this Page has added the app making the query in a Page tab
`hometown` string	Hometown of the band. Applicable to Bands
`hours` map<string, string>	Indicates a single range of opening hours for a day. Each day can have 2 different hours ranges. The keys in the map are in the form of `{day}_{number}_{status}`. `{day}` should be the first 3 characters of the day of the week, `{number}` should be either 1 or 2 to allow for the two different hours ranges per day. `{status}` should be either `open` or `close` to delineate the start or end of a time range. An example would be `mon_1_open` with value `17:00` and `mon_1_close` with value `21:15` which would represent a single opening range of 5pm to 9:15pm on Mondays
`impressum` string	Legal information about the Page publishers
`influences` string	Influences on the band. Applicable to Bands
`instant_articles_review_status` enum	Indicates the current Instant Articles review status for this page
`is_always_open` bool	Indicates whether this location is always open
`is_community_page` bool	Indicates whether the Page is a community Page
`is_eligible_for_branded_content` bool	Indicates whether the page is eligible for the branded content tool
`is_permanently_closed` bool	Whether the business corresponding to this Page is permanently closed
`is_published` bool	Indicates whether the Page is published and visible to non-admins
`is_unclaimed` bool	Indicates whether the Page is unclaimed
`is_verified` bool	Deprecated, use "verification_status". Pages with a large number of followers can be manually verified by Facebook as [having an authentic identity] (https://www.facebook.com/help/196050490547892). This field indicates whether the page is verified by this process. Deprecated
`is_webhooks_subscribed` bool	Indicates whether the application is subscribed for real time updates from this page
`keywords` null	Deprecated. Returns null Deprecated
`leadgen_form_preview_details` LeadGenFormPreviewDetails	The details needed to generate an accurate preview of a lead gen form
`leadgen_has_crm_integration` bool	Indicates whether this page hasApp subscribes page leads realtime update
`leadgen_tos_acceptance_time` datetime	Indicates the time when the TOS for running LeadGen Ads on the page was accepted
`leadgen_tos_accepted` bool	Indicates whether a user has accepted the TOS for running LeadGen Ads on the Page
`leadgen_tos_accepting_user` User	Indicates the user who accepted the TOS for running LeadGen Ads on the page
`link` string	The Page's Facebook URL Core
`location` Location	The location of this place. Applicable to all Places
`members` string	Members of this org. Applicable to Pages representing Team Orgs
`merchant_id` string	The instant workflow merchant id associated with the Page
`merchant_review_status` enum	Review status of the Page against FB commerce policies, this status decides whether the Page can use component flow
`mission` string	The company mission. Applicable to Companies
`mpg` string	MPG of the vehicle. Applicable to Vehicles
`name` string	The name of the Page Core Default
`name_with_location_descriptor` string	The name of the Page with its location and/or global brand descriptor. Only visible to a page admin. Non-page admins will get the same value as `name`.
`network` string	The TV network for the TV show. Applicable to TV Shows
`new_like_count` unsigned int32	The number of people who have liked the Page, since the last login. Only visible to a page admin
`offer_eligible` bool	Offer eligibility status. Only visible to a page admin
`overall_star_rating` float	Overall page rating based on rating survey from users on a scale of 1-5. This value is normalized and is not guaranteed to be a strict average of user ratings.
`parent_page` Page	Parent Page for this Page
`parking` PageParking	Parking information. Applicable to Businesses and Places
`payment_options` PagePaymentOptions	Payment options accepted by the business. Applicable to Restaurants or Nightlife
`personal_info` string	Personal information. Applicable to Pages representing People
`personal_interests` string	Personal interests. Applicable to Pages representing People
`pharma_safety_info` string	Pharmacy safety information. Applicable to Pharmaceutical companies
`phone` string	Phone number provided by a Page
`place_type` enum	For places, the category of the place
`plot_outline` string	The plot outline of the film. Applicable to Films
`preferred_audience` Targeting	Group of tags describing the preferred audienceof ads created for the Page
`press_contact` string	Press contact information of the band. Applicable to Bands
`price_range` string	Price range of the business. Applicable to Restaurants or Nightlife. Can be one of `$`, `$$`, `$$$`, `$$$$` or `Unspecified`
`produced_by` string	The productor of the film. Applicable to Films
`products` string	The products of this company. Applicable to Companies
`promotion_eligible` bool	Reason why a post isn't eligible for boosting. Only visible to Page Admins
`promotion_ineligible_reason` string	Reason, for which boosted posts are not eligible. Only visible to a page admin
`public_transit` string	Public transit to the business. Applicable to Restaurants or Nightlife
`publisher_space` PublisherSpace	Publisher Space for the page.
`rating_count` unsigned int32	Number of ratings for the page.
`recipient` numeric string	Messenger page scope id associated with page and a user using account_linking_token
`record_label` string	Record label of the band. Applicable to Bands
`release_date` string	The film's release date. Applicable to Films
`restaurant_services` PageRestaurantServices	Services the restaurant provides. Applicable to Restaurants
`restaurant_specialties` PageRestaurantSpecialties	The restaurant's specialties. Applicable to Restaurants
`schedule` string	The air schedule of the TV show. Applicable to TV Shows
`screenplay_by` string	The screenwriter of the film. Applicable to Films
`season` string	The season information of the TV Show. Applicable to TV Shows
`single_line_address` string	The page address, if any, in a simple single line format.
`starring` string	The cast of the film. Applicable to Films
`start_info` PageStartInfo	Information about when the entity represented by the Page was started
`store_location_descriptor` string	Location Page's store location descriptor
`store_number` unsigned int32	Unique store number for this location Page
`studio` string	The studio for the film production. Applicable to Films
`supports_instant_articles` bool	Indicates whether this Page supports Instant Articles
`talking_about_count` unsigned int32	The number of people talking about this Page
`unread_message_count` unsigned int32	Unread message count for the Page. Only visible to a page admin
`unread_notif_count` unsigned int32	Number of unread notifications. Only visible to a page admin
`unseen_message_count` unsigned int32	Unseen message count for the Page. Only visible to a page admin
`username` string	The alias of the Page. For example, for www.facebook.com/platform the username is 'platform' Core
`verification_status` string	Showing whether this Page is verified and in what color e.g. blue verified, gray verified or not verified
`voip_info` VoipInfo	Voip info
`website` string	The URL of the Page's website
`were_here_count` unsigned int32	The number of visits to this Page's location. If the Page setting Show map, check-ins and star ratings on the Page (under Page Settings > Page Info > Address) is disabled, then this value will also be disabled
`written_by` string	The writer of the TV show. Applicable to TV Shows

Edges

Edge	Description
`admin_notes`	Notes of this page
`albums`	Photo albums for this Page
`bc_sponsored_posts`	A list of posts where the page is tagged by a branded content sponsor.
`blocked`	User or Page Profiles blocked from this Page
`business_activities`	The business activities related to this page
`call_to_actions`	The call-to-action created by this Page
`canvas_elements`	The canvas elements associated with this page
`conversations`	This Page's conversations
`crosspost_pending_approval_pages`	Pages that have not given approval for crossposting
`crosspost_whitelisted_pages`	Pages whitelisted for crossposting
`curated_collections`	The curated collections created by this page
`events`	Events for this Page
`featured_videos_collection`	Featured Videos for this Page.
`feed`	The feed of posts (including status updates) and links published by this page, or by others on this page.
`global_brand_children`	Children Pages of a Global Page's root Page. Only root Page can return children Pages.
`insights`	This Page's Insights data. Global brand default Page will return its own insights data, while root Page will return integrated insights of the whole hierarchy.
`instagram_accounts`	Linked Instagram accounts for this Page
`instant_articles`	Instant articles associated with this Page
`instant_articles_insights`	Instant Article Aggregated Insights
`labels`	Labels of the Page
`leadgen_conditional_questions_group`	Creates conditional question.
`leadgen_context_cards`	A library of leadgen context cards that can be reused across forms
`leadgen_legal_content`	A library of leadgen legal content that can be reused across forms.
`leadgen_whitelisted_users`	List of all whitelisted users of a page.
`likes`	The Pages that like this Page.
`live_videos`	Live videos from this page
`locations`	The location Pages that are children of this Page
`media_fingerprints`	Media fingerprints from this page
`messenger_profile`	messenger profile
`milestones`	This Page's milestones
`nativeoffers`	The native offers created by this Page
`offers_v3`	offers v3
`page_backed_instagram_accounts`	Linked Page Backed Instagram accounts for this Page
`photos`	This Page's photos
`picture`	This Page's profile picture
`place_topics`	The place topic associated with the categories of the page
`posts`	The feed of posts (including status updates) and links published by this page, or by others on this page.
`product_catalogs`	Product catalogs owned by this page
`promotable_posts`	The feed of posts (including status updates) and links published by this page, or by others on this page.
`ratings`	Open Graph ratings given to this Page
`roles`	The Page's Admins
`saved_filters`	Filters saved in Page Publishing Tools
`saved_message_responses`	All message responses that are saved by a page
`screennames`	External accounts. Applicable to Pages representing people
`seasons`	Seasons for this show page
`settings`	Controllable settings for this page
`show_playlists`	Playlists for this show page
`subscribed_apps`	Applications that have real time update subscriptions for this Page. Note that we will only return information about the current app
`tabs`	This Page's tabs and the apps in them
`tagged`	The photos, videos, and posts in which the Page has been tagged. A derivative of /feeds
`thread_settings`	Messenger platform configs for the page
`threads`	A messages thread in Facebook Messenger
`tours`	tours
`video_broadcasts`	Video broadcasts from this page
`video_copyright_rules`	Video copyright rules from this page
`video_copyrights`	Video copyrights from this page
`video_lists`	Video Playlists for this Page
`videos`	Videos for this Page
`videos_you_can_use`	Provides a list of videos the Page can use for crossposting. Owners of these videos have granted permission for the Page to crosspost them.
`workflows`	Native component workflows available for this Page. Workflows allow people to perform actions like requesting appointments, buying tickets, and ordering from restaurants on Facebook.
`notes`	A Facebook Note created by a user or page.
`notifications`	page/notifications API
`questions`	Graph API Reference Question /question
`statuses`	The feed of status messages published by this page.

Validation Rules

Error	Description
100	Invalid parameter
200	Permissions error
210	User not visible
190	Invalid OAuth 2.0 Access Token
3001	Invalid query
275	Cannot determine the target object for this request. Currently supported objects include ad account, business account and associated objects.
262	Incorrect permission to publish pages
278	Reading advertisements requires an access token with the extended permission ads_read

Creating

You can't perform this operation on this endpoint.

You may perform a POST request to the following edges from this node:

Validation Rules

Error	Description
100	Invalid parameter
210	User not visible
200	Permissions error
370	Invalid call to update this page
371	Invalid Page location update
368	The action attempted has been deemed abusive or is otherwise disallowed
320	Photo edit failure
190	Invalid OAuth 2.0 Access Token
160	Invalid geolocation type

Updating

You can update a Page by making a POST request to /{page_id}.

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps

No data

Page management Apps

manage_pages
pages_show_list

Other Apps

No data

Parameters

Name	Description
`about` string	Update the `about` field
`allow_spherical_photo` boolean	Default value: `false` Indicates that we should allow this photo to be treated as a spherical photo. This param will only be used when uploading a new image file. 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.
`attire` enum{Unspecified, Casual, Dressy}	Update the `attire` field
`bio` string	Update the `bio` field
`category_list` list<numeric string>	Update the `category_list` field
`company_overview` string	Update the `company_overview` field
`contact_address` Object	Update the `contact_address` field
`city_id` city id
`street1` string
`street2` string
`zip` string
`cover` numeric string or integer	Update the `cover` field
`crossposting_pages` list<Object>	change pages permission to crosspost
`page_id` Page ID	Required
`allow` boolean	Required
`action` enum {1, 2, 3, 4}	Required
`culinary_team` string	Update the `culinary_team` field
`description` string	Update the `description` field
`directed_by` string	Update the `directed_by` field
`displayed_message_response_time` string	Page estimated message response time displayed to user
`emails` list<string>	Update the `emails` field
`focus_x` float	Cover photo focus x
`focus_y` float	Cover photo focus y
`food_styles` list<enum{Afghani, American (New), American (Traditional), Asian Fusion, Barbeque, Brazilian, Breakfast, British, Brunch, Buffets, Burgers, Burmese, Cajun/Creole, Caribbean, Chinese, Creperies, Cuban, Delis, Diners, Ethiopian, Fast Food, Filipino, Fondue, Food Stands, French, German, Greek and Mediterranean, Hawaiian, Himalayan/Nepalese, Hot Dogs, Indian/Pakistani, Irish, Italian, Japanese, Korean, Latin American, Mexican, Middle Eastern, Moroccan, Pizza, Russian, Sandwiches, Seafood, Singaporean, Soul Food, Southern, Spanish/Basque, Steakhouses, Sushi Bars, Taiwanese, Tapas Bars, Tex-Mex, Thai, Turkish, Vegan, Vegetarian, Vietnamese}>	Update the `food_styles` field
`general_info` string	Update the `general_info` field
`general_manager` string	Update the `general_manager` field
`genre` string	Update the `genre` field
`hours` dictionary { string : <> }	Update the `hours` field
`ignore_coordinate_warnings` boolean	Ignore coordinate warnings when updating this Page's location
`impressum` string	Update the `impressum` field
`instant_articles_submit_for_review` boolean	Submit Instant Articles on the Page for review
`is_always_open` boolean	Is this location always open?
`is_permanently_closed` boolean	Update the `is_permanently_closed` field
`is_published` boolean	Update the `is_published` field
`is_webhooks_subscribed` boolean	Is the application subscribed for real time updates from this page?
`location` Object	Update the `location` field
`city` string
`city_id` city id
`state` string
`country` string
`street` string
`zip` string
`latitude` float
`longitude` float
`mission` string	Update the `mission` field
`no_feed_story` boolean	Default value: `false` Don't generate a feed story for the cover photo
`no_notification` boolean	Default value: `false` Don't generate a notification for the cover photo
`offset_x` integer	Default value: `50` Cover photo offset x
`offset_y` integer	Default value: `50` Cover photo offset y
`parking` dictionary { enum{street, lot, valet} : <boolean> }	Update the `parking` field
`payment_options` dictionary { enum{visa, amex, mastercard, discover, cash_only} : <boolean> }	Update the `payment_options` field
`phone` string	Update the `phone` field
`plot_outline` string	Update the `plot_outline` field
`price_range` string	Update the `price_range` field
`public_transit` string	Update the `public_transit` field
`restaurant_services` dictionary { enum{reserve, walkins, groups, kids, takeout, delivery, catering, waiter, outdoor} : <boolean> }	Update the `restaurant_services` field
`restaurant_specialties` dictionary { enum{breakfast, lunch, dinner, coffee, drinks} : <boolean> }	Update the `restaurant_specialties` field
`scrape` boolean	Re-scrape the website associated with this Page
`service_details` string	Details of services provided by page. Can include delivery status/area/hours for the page.
`spherical_metadata` JSON object	A set of params describing an uploaded spherical photo. This param will only be used when uploading a new image file. 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
`ProjectionType` string	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
`CroppedAreaImageWidthPixels` integer	--- 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
`CroppedAreaImageHeightPixels` integer	--- 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
`FullPanoWidthPixels` integer	--- 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
`FullPanoHeightPixels` integer	--- 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
`CroppedAreaLeftPixels` integer	--- 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. Required
`CroppedAreaTopPixels` integer	--- 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. Required
`PoseHeadingDegrees` float
`PosePitchDegrees` float
`PoseRollDegrees` float
`InitialViewHeadingDegrees` float
`InitialViewPitchDegrees` float
`InitialViewRollDegrees` float	This is not currently supported
`InitialViewVerticalFOVDegrees` float	You can set the intial FOV of the image. Note that we support this vertical FOV parameter, but InitialViewHorizontalFOV listed in the Photo Sphere XMP Metadata spec is not currently supported
`PreProcessCropLeftPixels` integer
`PreProcessCropRightPixels` integer
`start_info` Object	Update the `start_info` field
`type` enum{Unspecified, Born, Founded, Started, Opened, Created, Launched}	Required
`date` Object
`year` integer
`month` integer
`day` integer
`store_location_descriptor` string	Update the `store_location_descriptor` field
`website` URL	Update the `website` field
`zoom_scale_x` float	Cover photo zoom scale x
`zoom_scale_y` float	Cover photo zoom scale y

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.

Struct {

success: bool,

}

You can update a Page by making a POST request to /{business_id}/pages.

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps

ads_management
manage_pages
business_management

Page management Apps

No data

Other Apps

No data

Parameters

Name	Description
`access_type` enum {OWNER, AGENCY}	access type Required
`page_id` Page ID	page id Required
`permitted_roles` list<enum {MANAGER, CONTENT_CREATOR, MODERATOR, ADVERTISER, INSIGHTS_ANALYST}>	permitted roles

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.

Struct {

access_status: string,

}

You may perform a POST request to the following edges from this node:

Validation Rules

Error	Description
100	Invalid parameter
210	User not visible
200	Permissions error
370	Invalid call to update this page
371	Invalid Page location update
368	The action attempted has been deemed abusive or is otherwise disallowed
320	Photo edit failure
190	Invalid OAuth 2.0 Access Token
160	Invalid geolocation type

Deleting

You can dissociate a Page from a Page by making a DELETE request to /{page_id}/locations.

Parameters

Name	Description
`location_page_id` Page ID	Page ID for the page to delete Required
`store_number` int64	Store number for the page to delete Required

Return Type

Struct {

success: bool,

}

You may perform a DELETE request to the following edges from this node:

Validation Rules

Error	Description
200	Permissions error
190	Invalid OAuth 2.0 Access Token
100	Invalid parameter