artisanpack-ui / bing-places

v1.0.0 2026-09-19 01:23 UTC

Requires

• php: ^8.2
• artisanpack-ui/core: ^1.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• artisanpack-ui/code-style: ^1.1
• artisanpack-ui/code-style-pint: ^1.1
• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• friendsofphp/php-cs-fixer: ^3.75
• laravel/pint: ^1.26
• orchestra/testbench: ^10.2|^11.0
• pestphp/pest: ^3.8|^4.0
• pestphp/pest-plugin-laravel: ^3.2|^4.1

MIT

• Jacob Martella

• bing
• laravel
• microsoft
• local-seo
• artisanpack-ui
• bing-places

Published on Packagist.org on 2026-09-19 01:29 UTC

README

OAuth-free, UI-free API client for the Bing Places for Business management API. Part of the ArtisanPack UI Local SEO stack; mirrors the shape of artisanpack-ui/google-business-profile (typed client, DTOs, TokenProvider contract, shared Http factory for Http::fake()). Downstream hosts bind the local TokenProvider to whichever source of Microsoft OAuth tokens they use — in Keystone CMS, that's the manager exposed by artisanpack-ui/microsoft-oauth.

Access to the Bing Places management API is restricted. Microsoft grants it through its agency / partner program, not through self-service signup. Until access is granted for a given Bing Places account, live API calls will fail with 403. This package is designed to be developed and released against Http::fake() fixtures so the code path is ready the day access lands. See the restricted-access reality for what is and is not gated.

Installation

composer require artisanpack-ui/bing-places

The service provider and the BingPlaces facade alias are auto-registered via Laravel's package discovery.

Requirements

• PHP 8.2+
• Laravel 10, 11, 12, or 13
• artisanpack-ui/core
• A source of Microsoft OAuth access tokens for the caller. In Keystone CMS and any other host that consumes artisanpack-ui/microsoft-oauth, the host binds this package's TokenProvider to a thin adapter around the manager that package exposes. This package does not require artisanpack-ui/microsoft-oauth directly — any implementation of the local contract works.

TokenProvider contract

Every client this package ships accepts an ArtisanPackUI\BingPlaces\Contracts\TokenProvider in its constructor and calls accessToken() on it before each outgoing request. No OAuth logic lives in this package — the host application binds whichever implementation fits.

use ArtisanPackUI\BingPlaces\Contracts\TokenProvider;

$this->app->bind( TokenProvider::class, function () {
    // In Keystone CMS this resolves to an adapter that delegates to the
    // manager exposed by artisanpack-ui/microsoft-oauth, which handles
    // refresh and per-user connection lookup transparently. Anywhere
    // else, wire up whatever exposes a fresh access token.
    return new MyTokenProvider();
} );

See the Token provider guide for stub, cached, and MicrosoftOAuth-backed examples.

Sync from Google Business Profile

The Bing Places management API is restricted, but Bing Places itself offers a first-party "Sync from Google Business Profile" import that most listings should use. When a business is already published to Google Business Profile, running the sync in the Bing Places UI is the recommended path — Bing pulls location data, hours, categories, and photos directly from Google, no management-API access required.

This package still ships the management-API client so that:

• Ongoing updates (post-sync edits, review replies, media uploads) can be pushed programmatically once API access is granted.
• Hosts that cannot rely on GBP as the source of truth (chains that publish to Bing independently, businesses without an active GBP profile) have a code path ready.

For most Keystone CMS deployments the recommendation is: sync from GBP first, then use this package for the incremental writes management-API access unlocks. See the GBP-sync path guide for the workflow.

Usage

Full usage docs will land as feature code is added. The container binding and helper are already available:

use ArtisanPackUI\BingPlaces\Facades\BingPlaces;

BingPlaces::…;        // static facade
bingPlaces();         // helper
app( 'bing-places' ); // container binding

Documentation

Full documentation lives in the docs/ directory:

• Home — package overview and what's inside.
• Getting started — install, bind a TokenProvider, and understand the restricted-access implication before your first call.
• Guide — the TokenProvider contract, the restricted-access reality, the GBP-sync path, and testing with Http::fake().
• Reference — API surface map.

Contributing

As an open source project, this package is open to contributions from anyone. Please read through the contributing guidelines to learn more about how you can contribute to this project.