2 out of 2 rated this helpful - Rate this topic

Search Registration and Launch Reference for Windows Phone

Windows Phone

March 22, 2012

With Windows Phone OS 7.1, applications can use App Connect to extend the search experience on Windows Phone. Using App Connect in your application primarily involves two steps: registering for search extensions that are relevant to your application and handling launches from App Connect deep link URIs. For each type of quick card, this topic describes the available extensions and the quick card parameters that are passed via the deep link URI. For more information about using App Connect with your application, see Search Extensibility Overview for Windows Phone and How to: Extend Search with App Connect for Windows Phone.

Important noteImportant Note:

Applications that abuse App Connect risk being pulled from the Marketplace. Register only for search extensions that are relevant to your application. To learn more about which extensions Bing associates with various quick cards, experiment with the Quick Card Sample.

The purpose of App Connect is to save the user time. Applications must use the App Connect URI parameters in a meaningful way. For example, use App Connect to automatically search within your own application when launched from a quick card. Use the Quick Card Sample to learn more about the URI parameter values that are passed from quick cards.

This topic describes the following quick cards:

  • Product Card: for items listed under the products heading in the web pivot page of search results

  • Place Card: for locations listed in the local pivot page of search results

  • Movie Card: for movies currently playing in theaters listed under the “Movies near…” heading in the web pivot page of search results

A product card describes information about a product. Product cards are typically launched from a list under the products heading in the web pivot page of search results. Products are categorized into multiple extensions. Product card information is sent to a Windows Phone application via parameters that are contained in an App Connect deep link URI.

Product Card Extensions

This section describes the extensions for product cards.

  • Bing_Products_Arts_and_Crafts

  • Bing_Products_Baby_and_Nursery

  • Bing_Products_Beauty_and_Fragrance

  • Bing_Products_Books_and_Magazines

  • Bing_Products_Cameras_and_Optics

  • Bing_Products_Car_and_Garage

  • Bing_Products_Clothing_and_Shoes

  • Bing_Products_Collectibles_and_Memorabilia

  • Bing_Products_Computing

  • Bing_Products_Electronics

  • Bing_Products_Flowers

  • Bing_Products_Gourmet_Food_and_Chocolate

  • Bing_Products_Health_and_Wellness

  • Bing_Products_Home_Furnishings

  • Bing_Products_Jewelry_and_Watches

  • Bing_Products_Kitchen_and_Housewares

  • Bing_Products_Lawn_and_Garden

  • Bing_Products_Miscellaneous

  • Bing_Products_Movies

  • Bing_Products_Music

  • Bing_Products_Musical_Instruments

  • Bing_Products_Office_Products

  • Bing_Products_Pet_Supplies

  • Bing_Products_Software

  • Bing_Products_Sports_and_Outdoors

  • Bing_Products_Tools_and_Hardware

  • Bing_Products_Toys

  • Bing_Products_Travel

  • Bing_Products_Vehicles

  • Bing_Products_Video_Games

Product Card Launch Parameters

The following parameters are used to describe a product card:

  1. ProductName: The name of the product

  2. Category: A comma-delimited list of extensions related to the product

Example:

app://046B642D-C70D-4D8D-95E2-D92236763294/_default#/SearchExtras?ProductName=XBox 360&Category=Bing_Products_Electronics,Bing_Products_Office_Products

A place card describes information about a location. Place cards are typically launched from a list of locations in the local pivot page of search results. Places are categorized into multiple extensions. Place card information is sent to a Windows Phone application via parameters that are contained in an App Connect deep link URI.

Place Card Extensions

This section describes the extensions for place cards.

  • Bing_Places_Arts_and_Entertainment

  • Bing_Places_Automotive_and_Vehicles

  • Bing_Places_Business_to_Business

  • Bing_Places_Computers_and_Technology

  • Bing_Places_Education

  • Bing_Places_Food_and_Dining

  • Bing_Places_Government_and_Community

  • Bing_Places_Health_and_Beauty

  • Bing_Places_Home_and_Family

  • Bing_Places_Legal_and_Finance

  • Bing_Places_Professionals_and_Services

  • Bing_Places_Real_Estate_and_Construction

  • Bing_Places_Sports_and_Recreation

  • Bing_Places_Shopping

  • Bing_Places_Travel

Place Card Launch Parameters

The following parameters are used to describe a place card:

  1. PlaceName: The name of the place

  2. PlaceLatitude: The latitude of the place

  3. PlaceLongitude: The longitude of the place

  4. PlaceAddress: The address of the place

  5. Category: A comma-delineated list of extensions related to the place

Example:

app://046B642D-C70D-4D8D-95E2-D92236763294/_default#/SearchExtras?PlaceName=Fourth Coffee&PlaceLatitude=47.64602&PlaceLongitude=-122.135074&PlaceAddress=1234 Microsoft Way, WA, 98101&Category=Bing_Places_Food_and_Dining

A movie card describes information about a movie currently playing in theaters. Movie cards are typically launched from a list under the “Movies near…” heading in the web pivot page of search results. Movies are not categorized into multiple extensions. Movie card information is sent to a Windows Phone application via a parameter that is contained in an App Connect deep link URI.

Movie Card Extension

Use the following extension to register for movie cards:

  • Bing_Movies

Movie Card Launch Parameters

The following parameters are used to describe a movie card:

  1. MovieName: The name of the movie currently playing in theaters

  2. Category: The extensions related to the movie

Example:

app://046B642D-C70D-4D8D-95E2-D92236763294/_default#/SearchExtras?MovieName=Adventure Works&Category=Bing_Movies

Did you find this helpful?
(1500 characters remaining)