REST Resource: accounts.locations

منبع: مکان

یک مکان. برای توضیح دقیق این فیلدها به مقاله مرکز راهنمایی یا برای فهرستی از دسته‌های کسب‌وکار معتبر به نقطه پایانی دسته مراجعه کنید.

نمایندگی JSON
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
زمینه های
name

string

شناسه Google برای این مکان به شکل: accounts/{accountId}/locations/{locationId}

در زمینه مسابقات، این فیلد پر نخواهد شد.

languageCode

string

زبان مکان. در حین ایجاد تنظیم شده و به روز نمی شود.

storeCode

string

شناسه خارجی برای این مکان، که باید در یک حساب مشخص منحصر به فرد باشد. این وسیله ای برای مرتبط کردن مکان با سوابق خود است.

locationName

string

نام مکان باید نشان دهنده نام واقعی کسب و کار شما باشد، همانطور که به طور مداوم در ویترین فروشگاه، وب سایت و لوازم التحریر شما استفاده می شود و برای مشتریان شناخته شده است. هر گونه اطلاعات اضافی، در صورت لزوم، می تواند در سایر زمینه های منبع گنجانده شود (به عنوان مثال، Address ، Categories ). اطلاعات غیر ضروری را به نام خود اضافه نکنید (مثلاً «Google» را به «Google Inc. - Mountain View Corporate Headquarters» ترجیح دهید). برچسب‌های بازاریابی، کدهای فروشگاه، نویسه‌های خاص، ساعات کاری یا وضعیت بسته/باز بودن، شماره تلفن، نشانی‌های وب سایت، اطلاعات خدمات/محصول، مکان/آدرس یا مسیرها، یا اطلاعات مربوط به محدودیت را شامل نشود (به عنوان مثال، «Chase ATM in Duane Reade ").

primaryPhone

string

شماره تلفنی که تا حد امکان مستقیماً به مکان کسب و کار شما متصل می شود. در صورت امکان به جای شماره تلفن مرکزی مرکز تماس از یک شماره تلفن محلی استفاده کنید.

additionalPhones[]

string

حداکثر دو شماره تلفن (تلفن همراه یا ثابت، بدون فکس) که با آن می توان با کسب و کار شما تماس گرفت، علاوه بر شماره تلفن اصلی.

address

object ( PostalAddress )

یک آدرس دقیق و دقیق برای توصیف مکان کسب و کار شما. صندوق پستی یا صندوق پستی واقع در مکان های دور قابل قبول نیست. در این زمان، می توانید حداکثر پنج مقدار addressLines را در آدرس تعیین کنید.

primaryCategory

object ( Category )

دسته‌ای که به بهترین شکل کسب‌وکار اصلی این مکان را توصیف می‌کند.

additionalCategories[]

object ( Category )

دسته های اضافی برای توصیف کسب و کار شما. دسته‌ها به مشتریان شما کمک می‌کنند تا نتایج دقیق و خاصی را برای خدماتی که به آن‌ها علاقه‌مند هستند بیابند. برای اینکه اطلاعات کسب‌وکارتان دقیق و زنده بماند، مطمئن شوید که از کمترین دسته‌بندی ممکن برای توصیف کلی کسب‌وکار اصلی خود استفاده می‌کنید. دسته بندی هایی را انتخاب کنید که تا حد امکان خاص هستند، اما نماینده کسب و کار اصلی شما هستند.

websiteUrl

string

یک URL برای این کسب و کار. در صورت امکان، به جای یک وب‌سایت/URL عمومی که همه مکان‌ها یا نام تجاری را نشان می‌دهد، از نشانی اینترنتی استفاده کنید که نشان‌دهنده این مکان تجاری فردی است.

regularHours

object ( BusinessHours )

ساعات کاری برای کسب و کار

specialHours

object ( SpecialHours )

ساعات کاری ویژه برای کسب و کار این معمولاً شامل ساعات تعطیلات و سایر اوقات خارج از ساعات کاری عادی می شود. اینها ساعات کاری منظم را لغو می کنند.

serviceArea

object ( ServiceAreaBusiness )

مشاغل حوزه خدمات خدمات خود را در محل مشتری ارائه می دهند. اگر این کسب‌وکار یک کسب‌وکار با منطقه خدماتی است، این قسمت منطقه(های) خدماتی توسط کسب‌وکار را توصیف می‌کند.

locationKey

object ( LocationKey )

مجموعه‌ای از کلیدها که این کسب‌وکار را به سایر دارایی‌های Google، مانند صفحه Google+‎ و مکان‌های Google Maps مرتبط می‌کند.

labels[]

string

مجموعه ای از رشته های آزاد که به شما امکان می دهد کسب و کار خود را برچسب گذاری کنید. این برچسب ها رو به روی کاربر نیستند. فقط شما می توانید آنها را ببینید محدود به 255 کاراکتر (در هر برچسب).

adWordsLocationExtensions

object ( AdWordsLocationExtensions )

اطلاعات اضافی که در AdWords ظاهر می شود.

latlng

object ( LatLng )

طول و عرض جغرافیایی ارائه شده توسط کاربر. هنگام ایجاد یک مکان، در صورت موفقیت آمیز بودن کدهای جغرافیایی آدرس ارائه شده، این فیلد نادیده گرفته می شود. این فیلد تنها در صورت درخواست‌های دریافت بازگردانده می‌شود که مقدار latlng ارائه‌شده توسط کاربر در حین ایجاد پذیرفته شود، یا مقدار latlng از طریق وب‌سایت نمایه کسب‌وکار به‌روزرسانی شده باشد. این فیلد به روز نمی شود.

openInfo

object ( OpenInfo )

پرچمی که نشان می دهد مکان در حال حاضر برای تجارت باز است یا خیر.

locationState

object ( LocationState )

فقط خروجی مجموعه ای از بولی ها که وضعیت یک مکان را منعکس می کند.

attributes[]

object ( Attribute )

ویژگی های این مکان.

metadata

object ( Metadata )

فقط خروجی اطلاعات اضافی غیر قابل ویرایش توسط کاربر.

priceLists[]
(deprecated)

object ( PriceList )

منسوخ شده: اطلاعات لیست قیمت برای این مکان.

profile

object ( Profile )

کسب و کار شما را با صدای خودتان توصیف می کند و داستان منحصر به فرد کسب و کار و پیشنهادات شما را با کاربران به اشتراک می گذارد.

relationshipData

object ( RelationshipData )

تمام مکان ها و زنجیره مربوط به این یکی.

moreHours[]

object ( MoreHours )

ساعات بیشتر برای بخش های مختلف یک کسب و کار یا مشتریان خاص.

ساعات کاری

نشان دهنده دوره های زمانی است که این مکان برای کسب و کار باز است. مجموعه ای از نمونه های TimePeriod را نگه می دارد.

نمایندگی JSON
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
زمینه های
periods[]

object ( TimePeriod )

مجموعه ای از زمان هایی که این مکان برای تجارت باز است. هر دوره نشان دهنده محدوده ای از ساعاتی است که مکان در طول هفته باز است.

بازه زمانی

بازه زمانی باز بودن کسب و کار را نشان می دهد که در روز/زمان باز مشخص شده شروع می شود و در روز/زمان بسته مشخص بسته می شود. زمان بسته شدن باید بعد از زمان افتتاحیه، به عنوان مثال بعد از آن در همان روز، یا در یک روز بعد رخ دهد.

نمایندگی JSON
{
  "openDay": enum (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
زمینه های
openDay

enum ( DayOfWeek )

day of the week را نشان می دهد که این دوره از آن شروع می شود.

openTime

string

زمان در قالب توسعه یافته ISO 8601 24 ساعته (hh:mm). مقادیر معتبر 00:00-24:00 هستند، که در آن ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است.

closeDay

enum ( DayOfWeek )

day of the week را نشان می دهد که این دوره به پایان می رسد.

closeTime

string

زمان در قالب توسعه یافته ISO 8601 24 ساعته (hh:mm). مقادیر معتبر 00:00-24:00 هستند، که در آن ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است.

روز هفته

یک روز از هفته را نشان می دهد.

Enums
DAY_OF_WEEK_UNSPECIFIED روز هفته نامشخص است.
MONDAY دوشنبه
TUESDAY سهشنبه
WEDNESDAY چهار شنبه
THURSDAY پنج شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

ساعات ویژه

مجموعه ای از دوره های زمانی را نشان می دهد که ساعات عملیاتی یک مکان با ساعات کاری عادی آن متفاوت است.

نمایندگی JSON
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
زمینه های
specialHourPeriods[]

object ( SpecialHourPeriod )

فهرستی از استثنائات مربوط به ساعات کاری عادی کسب و کار.

Special HourPeriod

نشان دهنده یک دوره زمانی است که ساعات عملیاتی یک مکان با ساعات کاری عادی آن متفاوت است. یک بازه ساعتی خاص باید محدوده ای کمتر از 24 ساعت را نشان دهد. openTime و startDate باید قبل از closeTime و endDate باشند. closeTime و endDate می‌تواند تا ساعت 11:59 صبح روز بعد از startDate مشخص شده افزایش یابد. به عنوان مثال، ورودی های زیر معتبر هستند:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

ورودی های زیر معتبر نیستند:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
نمایندگی JSON
{
  "startDate": {
    object (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
زمینه های
startDate

object ( Date )

تاریخ تقویمی این دوره ساعتی ویژه در تاریخ شروع می شود.

openTime

string

زمان دیوار در startDate هنگامی که یک مکان باز می شود، در قالب 24 ساعته ISO 8601 توسعه یافته بیان شده است. (hh:mm) مقادیر معتبر 00:00-24:00 هستند، که در آن 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است. اگر isClosed نادرست است باید مشخص شود.

endDate

object ( Date )

تاریخ تقویمی که این دوره ساعتی ویژه به پایان می رسد. اگر قسمت endDate تنظیم نشده است، به طور پیش‌فرض تاریخ مشخص‌شده در startDate را تعیین کنید. در صورت تنظیم، این فیلد باید برابر یا حداکثر 1 روز پس از startDate باشد.

closeTime

string

زمان دیوار در endDate زمانی که یک مکان بسته می شود، در قالب 24 ساعته ISO 8601 توسعه یافته بیان شده است. (hh:mm) مقادیر معتبر 00:00-24:00 هستند، که در آن 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است. اگر isClosed نادرست است باید مشخص شود.

isClosed

boolean

اگر درست باشد، endDate ، openTime و closeTime نادیده گرفته می‌شوند و تاریخ مشخص‌شده در startDate به‌عنوان مکان بسته‌شده برای کل روز تلقی می‌شود.

Service AreaBusiness

مشاغل منطقه خدماتی خدمات خود را در محل مشتری (به عنوان مثال، یک قفل ساز یا لوله کش) ارائه می دهند.

نمایندگی JSON
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
زمینه های
businessType

enum ( BusinessType )

type کسب و کار منطقه خدماتی را نشان می دهد.

coverageArea میدان اتحادیه . منطقه تحت پوششی را که کسب و کار خدمات ارائه می دهد را نشان می دهد. coverageArea تنها می تواند یکی از موارد زیر باشد:
radius

object ( PointRadius )

فقط خروجی منطقه ای که این کسب و کار به آن خدمات می دهد حول یک نقطه متمرکز است.

places

object ( Places )

منطقه ای که این کسب و کار به آن خدمات می دهد از طریق مجموعه ای از مکان ها تعریف شده است.

نوع کسب و کار

نشان می‌دهد که آیا این کسب‌وکار فقط در محل مشتری (مثلاً یک کامیون یدک‌کش) خدمات ارائه می‌دهد یا هم در یک آدرس و هم در محل (مثلاً یک پیتزافروشی با منطقه غذاخوری که به مشتریان نیز تحویل می‌دهد).

Enums
BUSINESS_TYPE_UNSPECIFIED فقط خروجی مشخص نشده است.
CUSTOMER_LOCATION_ONLY خدمات را فقط در منطقه اطراف (نه در آدرس کسب و کار) ارائه می دهد.
CUSTOMER_AND_BUSINESS_LOCATION خدمات را در آدرس کسب و کار و منطقه اطراف ارائه می دهد.

Point Radius

شعاع اطراف یک نقطه خاص (طول/طول جغرافیایی).

نمایندگی JSON
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
زمینه های
latlng

object ( LatLng )

طول و عرض جغرافیایی که مرکز یک ناحیه را که با شعاع تعریف شده است مشخص می کند.

radiusKm

number

فاصله بر حسب کیلومتر از ناحیه اطراف نقطه.

LatLng

شیئی که نشان دهنده یک جفت طول و عرض جغرافیایی است. این به صورت یک جفت دوتایی برای نشان دادن درجه عرض جغرافیایی و درجه طول جغرافیایی بیان می شود. مگر اینکه طور دیگری مشخص شده باشد، این شی باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال شده باشند.

نمایندگی JSON
{
  "latitude": number,
  "longitude": number
}
زمینه های
latitude

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

longitude

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

مکان ها

اتحاد مناطقی که با مجموعه ای از مکان ها نشان داده شده اند را تعریف می کند.

نمایندگی JSON
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
زمینه های
placeInfos[]

object ( PlaceInfo )

مناطق نشان داده شده توسط شناسه مکان. محدود به حداکثر 20 مکان.

PlaceInfo

منطقه ای را تعریف می کند که با شناسه مکان نشان داده می شود.

نمایندگی JSON
{
  "name": string,
  "placeId": string
}
زمینه های
name

string

نام محلی مکان. به عنوان مثال، Scottsdale, AZ .

placeId

string

شناسه محل. باید با یک منطقه مطابقت داشته باشد.

LocationKey

منابع کلیدی جایگزین/جانشین برای یک مکان.

نمایندگی JSON
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
زمینه های
plusPageId

string

فقط خروجی اگر این مکان دارای یک صفحه +Google مرتبط با آن باشد، با شناسه صفحه +Google برای این مکان پر می شود.

placeId

string

اگر این مکان تأیید شده باشد و به Google Maps متصل باشد/در Google Maps ظاهر شود، این قسمت با شناسه مکان برای مکان پر می شود. این شناسه را می توان در API های مختلف Places استفاده کرد.

اگر این مکان تأیید نشده باشد، در صورتی که مکان با مکانی که در Google Maps ظاهر می‌شود مرتبط باشد، ممکن است این فیلد پر شود.

این فیلد را می توان در حین ایجاد تماس ها تنظیم کرد، اما نه برای به روز رسانی.

bool اضافی explicitNoPlaceId واجد شرایط است که آیا شناسه مکان تنظیم نشده عمدی است یا خیر.

explicitNoPlaceId

boolean

فقط خروجی مقدار true نشان می‌دهد که شناسه مکان تنظیم‌نشده عمدی است، که با عدم ارتباطی که هنوز ایجاد نشده است متفاوت است.

requestId

string

فقط خروجی از requestId برای ایجاد این مکان استفاده شده است. اگر این مکان خارج از Google My Business API یا مکان‌های نمایه کسب‌وکار ایجاد شده باشد، ممکن است خالی باشد.

AdWordsLocationExtensions

اطلاعات اضافی که در AdWords ظاهر می شود.

نمایندگی JSON
{
  "adPhone": string
}
زمینه های
adPhone

string

یک شماره تلفن جایگزین برای نمایش در افزونه های مکان AdWords به جای شماره تلفن اصلی مکان.

OpenInfo

اطلاعات مربوط به وضعیت افتتاح کسب و کار.

نمایندگی JSON
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
زمینه های
status

enum ( OpenForBusiness )

نشان می دهد که آیا مکان در حال حاضر برای تجارت باز است یا خیر. همه مکان‌ها به‌طور پیش‌فرض باز هستند، مگر اینکه به‌روزرسانی شوند تا بسته شوند.

canReopen

boolean

فقط خروجی نشان می دهد که آیا این کسب و کار واجد شرایط بازگشایی است یا خیر.

openingDate

object ( Date )

تاریخی که مکان برای اولین بار باز شد. اگر روز دقیق مشخص نباشد، فقط ماه و سال قابل ارائه است. تاریخ باید در گذشته باشد یا بیش از یک سال در آینده نباشد.

OpenForBusiness

وضعیت یک مکان را نشان می دهد.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED مشخص نشده است.
OPEN نشان می دهد که مکان باز است.
CLOSED_PERMANENTLY نشان می دهد که مکان برای همیشه بسته شده است.
CLOSED_TEMPORARILY نشان می دهد که مکان به طور موقت بسته شده است. این مقدار ممکن است فقط برای مکان های منتشر شده اعمال شود (یعنی locationState.is_published = true). هنگام به‌روزرسانی فیلد وضعیت به این مقدار، مشتریان باید updateMask به طور صریح روی openInfo.status تنظیم کنند. هیچ ماسک به‌روزرسانی دیگری را نمی‌توان در طول این تماس به‌روزرسانی تنظیم کرد. این یک محدودیت موقتی است که به زودی رفع خواهد شد.

وضعیت موقعیت

شامل مجموعه ای از بولی ها است که وضعیت یک مکان را منعکس می کند.

نمایندگی JSON
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
زمینه های
isGoogleUpdated

boolean

فقط خروجی نشان می‌دهد که آیا شناسه مکان مرتبط با این مکان به‌روزرسانی دارد یا خیر.

isDuplicate

boolean

فقط خروجی نشان می دهد که آیا مکان تکراری مکان دیگری است یا خیر.

isSuspended

boolean

فقط خروجی نشان می دهد که آیا مکان به حالت تعلیق درآمده است یا خیر. مکان‌های معلق برای کاربران نهایی در محصولات Google قابل مشاهده نیستند. اگر فکر می کنید این اشتباه بوده است، به مقاله مرکز راهنمایی مراجعه کنید.

canUpdate

boolean

فقط خروجی نشان می دهد که آیا مکان می تواند به روز شود.

canDelete

boolean

فقط خروجی نشان می دهد که آیا می توان مکان را با استفاده از Google My Business API حذف کرد یا خیر.

isVerified

boolean

فقط خروجی نشان می دهد که آیا مکان تأیید شده است یا خیر.

needsReverification

boolean

فقط خروجی نشان می دهد که آیا مکان به تأیید مجدد نیاز دارد یا خیر.

isPendingReview

boolean

فقط خروجی نشان می دهد که آیا بررسی مکان در انتظار است یا خیر.

isDisabled

boolean

فقط خروجی نشان می دهد که آیا مکان غیرفعال است یا خیر.

isPublished

boolean

فقط خروجی نشان می دهد که آیا مکان منتشر شده است یا خیر.

isDisconnected

boolean

فقط خروجی نشان می دهد که آیا ارتباط مکان با مکانی در Google Maps قطع شده است یا خیر.

isLocalPostApiDisabled

boolean

فقط خروجی نشان می دهد که accounts.locations.localPosts برای این مکان غیرفعال است یا خیر.

canModifyServiceList

boolean

فقط خروجی نشان می دهد که آیا فهرست می تواند یک ServiceList را تغییر دهد یا خیر.

canHaveFoodMenus

boolean

فقط خروجی نشان می دهد که آیا فهرست برای منوی غذا واجد شرایط است یا خیر.

hasPendingEdits

boolean

فقط خروجی نشان می دهد که آیا هر یک از ویژگی های این مکان در حالت تعلیق ویرایش هستند یا خیر.

hasPendingVerification

boolean

فقط خروجی نشان می‌دهد که آیا مکان درخواست‌های تأیید معلق دارد یا خیر.

canOperateHealthData

boolean

فقط خروجی نشان می دهد که آیا مکان می تواند بر روی داده های Health کار کند یا خیر.

canOperateLodgingData

boolean

فقط خروجی نشان می دهد که آیا مکان می تواند روی داده های اقامتگاه کار کند یا خیر.

صفت

یک ویژگی مکان. ویژگی ها اطلاعات بیشتری در مورد یک مکان ارائه می دهند. ویژگی هایی که می توان روی یک مکان تنظیم کرد ممکن است بر اساس ویژگی های آن مکان (به عنوان مثال، دسته) متفاوت باشد. ویژگی‌های موجود توسط Google تعیین می‌شوند و ممکن است بدون تغییرات API اضافه و حذف شوند.

نمایندگی JSON
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
زمینه های
attributeId

string

شناسه صفت. شناسه‌های مشخصه توسط Google ارائه می‌شوند.

valueType

enum ( AttributeValueType )

فقط خروجی نوع مقداری که این ویژگی حاوی آن است. این باید برای تعیین نحوه تفسیر مقدار استفاده شود.

values[]

value ( Value format)

مقادیر این ویژگی نوع مقادیر ارائه شده باید با مقادیر مورد انتظار برای آن ویژگی مطابقت داشته باشد. AttributeValueType را ببینید. این یک فیلد تکراری است که ممکن است چندین مقدار مشخصه ارائه شود. انواع مشخصه ها فقط از یک مقدار پشتیبانی می کنند.

repeatedEnumValue

object ( RepeatedEnumAttributeValue )

وقتی نوع مقدار مشخصه REPEATED_ENUM باشد، این مقدار ویژگی را در بر می گیرد و فیلدهای مقادیر دیگر باید خالی باشند.

urlValues[]

object ( UrlAttributeValue )

هنگامی که نوع مقدار مشخصه URL است، این فیلد حاوی مقدار(های) این ویژگی است و فیلدهای مقادیر دیگر باید خالی باشند.

RepeatedEnumAttributeValue

مقادیر برای یک ویژگی با valueType REPEATED_ENUM. این شامل دو لیست از شناسه‌های مقدار است: آنهایی که تنظیم شده‌اند (true) و آنهایی که تنظیم نشده‌اند (false). مقادیر غایب ناشناخته در نظر گرفته می شوند. حداقل یک مقدار باید مشخص شود.

نمایندگی JSON
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
زمینه های
setValues[]

string

مقادیر Enum که تنظیم شده اند.

unsetValues[]

string

مقادیر Enum که تنظیم نشده اند.

UrlAttributeValue

مقادیر برای یک ویژگی با valueType URL.

نمایندگی JSON
{
  "url": string
}
زمینه های
url

string

URL.

فراداده

اطلاعات اضافی غیر قابل ویرایش توسط کاربر در مورد مکان.

نمایندگی JSON
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
زمینه های
duplicate
(deprecated)

object ( Duplicate )

اطلاعات مربوط به مکانی که این مکان تکرار می کند. فقط زمانی ارائه می شود که locationState.is_duplicate درست باشد. منسوخ شده: ما دیگر از اطلاعات دقیق برای موارد تکراری پشتیبانی نمی کنیم.

mapsUrl

string

پیوندی به مکان در Maps.

newReviewUrl

string

پیوندی به صفحه‌ای در جستجوی Google که در آن مشتری می‌تواند نظری برای موقعیت مکانی بگذارد.

تکراری

اطلاعات مربوط به مکانی که این مکان تکرار می کند.

نمایندگی JSON
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
زمینه های
locationName

string

نام منبع مکانی که این مورد تکراری است. فقط در صورتی پر می شود که کاربر احراز هویت شده حقوق دسترسی به آن مکان را داشته باشد و آن مکان حذف نشود.

placeId

string

شناسه مکان مکانی که این مورد تکراری است.

access

enum ( Access )

نشان می دهد که آیا کاربر به مکانی که کپی می کند دسترسی دارد یا خیر.

دسترسی داشته باشید

سطح دسترسی کاربر به مکانی که آن را کپی می کند. این جایگزین مالکیت می شود و باید به جای آن استفاده شود.

Enums
ACCESS_UNSPECIFIED مشخص نشده است.
ACCESS_UNKNOWN نمی توان تعیین کرد که آیا کاربر به مکانی که کپی می کند دسترسی دارد یا خیر.
ALLOWED کاربر به مکانی که کپی می کند دسترسی دارد.
INSUFFICIENT کاربر به مکانی که کپی می کند دسترسی ندارد.

لیست قیمت

منسوخ شده: فهرستی از اطلاعات قیمت اقلام. لیست قیمت ها به صورت یک یا چند لیست قیمتی ساخته می شوند که هر کدام شامل یک یا چند بخش با یک یا چند مورد است. به عنوان مثال، فهرست قیمت غذا ممکن است نشان دهنده منوی صبحانه/ناهار/شام باشد، با بخش هایی برای همبرگر/استیک/غذاهای دریایی.

نمایندگی JSON
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
زمینه های
priceListId

string

ضروری. شناسه لیست قیمت لیست قیمت، بخش، و شناسه کالا را نمی توان در این مکان تکراری کرد.

labels[]

object ( Label )

ضروری. برچسب‌های برچسب‌گذاری شده با زبان برای لیست قیمت.

sourceUrl

string

URL منبع اختیاری جایی که لیست قیمت از آنجا بازیابی شده است. به عنوان مثال، این می تواند URL صفحه ای باشد که به طور خودکار برای پر کردن اطلاعات منو حذف شده است.

sections[]

object ( Section )

ضروری. بخش هایی برای این لیست قیمت. هر لیست قیمت باید حداقل شامل یک بخش باشد.

برچسب

برچسبی که باید هنگام نمایش لیست قیمت، بخش یا کالا مورد استفاده قرار گیرد.

نمایندگی JSON
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
زمینه های
displayName

string

ضروری. نام نمایشی برای لیست قیمت، بخش یا مورد.

description

string

اختیاری. شرح لیست قیمت، بخش یا مورد.

languageCode

string

اختیاری. کد زبان BCP-47 که این رشته ها برای آن اعمال می شوند. فقط یک مجموعه از برچسب ها را می توان در هر زبان تنظیم کرد.

بخش

بخشی از لیست قیمت شامل یک یا چند مورد.

نمایندگی JSON
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
زمینه های
sectionId

string

ضروری. شناسه برای بخش لیست قیمت، بخش، و شناسه کالا را نمی توان در این مکان تکراری کرد.

labels[]

object ( Label )

ضروری. برچسب‌های دارای برچسب زبان برای بخش. توصیه می کنیم نام بخش ها و توضیحات 140 کاراکتر یا کمتر باشد. حداقل یک مجموعه از برچسب ها مورد نیاز است.

sectionType

enum ( SectionType )

اختیاری. قسمت لیست قیمت فعلی را تایپ کنید. مقدار پیش فرض FOOD است.

items[]

object ( Item )

اقلامی که در این بخش از لیست قیمت موجود است.

نوع بخش

نوع بخش

Enums
SECTION_TYPE_UNSPECIFIED مشخص نشده است.
FOOD بخش شامل مواردی است که نشان دهنده غذا است.
SERVICES بخش شامل مواردی است که خدمات را نشان می دهد.

مورد

یک آیتم فهرست واحد. هر تغییری از یک کالا در لیست قیمت باید آیتم خود را با داده های قیمتی خاص خود داشته باشد.

نمایندگی JSON
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
زمینه های
itemId

string

ضروری. شناسه برای کالا لیست قیمت، بخش، و شناسه کالا را نمی توان در این مکان تکراری کرد.

labels[]

object ( Label )

ضروری. برچسب‌های برچسب‌گذاری شده با زبان برای مورد. توصیه می کنیم نام آیتم ها 140 نویسه یا کمتر و توضیحات 250 نویسه یا کمتر باشد. حداقل یک مجموعه از برچسب ها مورد نیاز است.

price

object ( Money )

اختیاری. قیمت کالا.

پول

مقداری پول را با نوع ارز آن نشان می دهد.

نمایندگی JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
زمینه های
currencyCode

string

کد ارز سه حرفی تعریف شده در ISO 4217.

units

string ( int64 format)

کل واحدهای مقدار. به عنوان مثال، اگر currencyCode "USD" باشد، 1 واحد یک دلار آمریکا است.

nanos

integer

تعداد نانو (10^-9) واحد مقدار. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می تواند مثبت، صفر یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. به عنوان مثال 1.75-$ به صورت units =-1 و nanos =-750,000,000 نشان داده می شود.

مشخصات

تمام اطلاعات مربوط به نمایه مکان.

نمایندگی JSON
{
  "description": string
}
زمینه های
description

string

شرح مکان با صدای خودتان، غیر قابل ویرایش توسط شخص دیگری.

RelationshipData

اطلاعات تمام مکان های والدین و فرزندان مربوط به این یکی.

نمایندگی JSON
{
  "parentChain": string
}
زمینه های
parentChain

string

نام منبع زنجیره ای که این مکان عضو آن است. How to find Chain ID

بیشتر ساعت

دوره های زمانی که در طی آن یک مکان برای انواع خاصی از کسب و کار باز است.

نمایندگی JSON
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
زمینه های
hoursTypeId

string

ضروری. نوع ساعت مشتریان باید با {#link businessCategories:BatchGet} تماس بگیرند تا انواع ساعت های پشتیبانی شده را برای دسته بندی مکان هایشان دریافت کنند.

periods[]

object ( TimePeriod )

ضروری. مجموعه ای از زمان هایی که این مکان باز است. هر دوره نشان دهنده محدوده ای از ساعاتی است که مکان در طول هفته باز است.

مواد و روش ها

associate

 یک مکان را به شناسه مکان مرتبط می کند.

batchGet

 همه مکان های مشخص شده را در حساب داده شده دریافت می کند.

batchGetReviews

 فهرست صفحه بندی شده نظرات را برای همه مکان های مشخص شده برمی گرداند.

clearAssociation

 ارتباط بین یک مکان و شناسه مکان آن را پاک می کند.

create

 یک location جدید متعلق به حساب مشخص شده ایجاد می کند و آن را برمی گرداند.

delete

 یک مکان را حذف می کند.

fetchVerificationOptions

 همه گزینه های تأیید واجد شرایط را برای یک مکان به زبان خاصی گزارش می دهد.

findMatches

 همه مکان های ممکن را که با مکان مشخص شده مطابقت دارند را پیدا می کند.

get

 مکان مشخص شده را دریافت می کند.

getFoodMenus

 منوهای غذایی یک مکان خاص را برمی گرداند.

getGoogleUpdated

 نسخه به‌روزرسانی‌شده Google مکان مشخص‌شده را دریافت می‌کند.

getHealthProviderAttributes

 ویژگی های ارائه دهنده Health یک مکان خاص را برمی گرداند.

getServiceList

 لیست خدمات مشخص شده یک مکان را دریافت کنید.

list

 مکان های حساب مشخص شده را فهرست می کند.

patch

 مکان مشخص شده را به روز می کند.

reportInsights

 گزارشی حاوی اطلاعات آماری درباره یک یا چند معیار براساس مکان را برمی‌گرداند.

transfer
(deprecated)

 مکان را از حسابی که کاربر دارد به حساب دیگری که همان کاربر مدیریت می کند منتقل می کند.

updateFoodMenus

 منوهای غذایی یک مکان خاص را به روز می کند.

updateHealthProviderAttributes

 ویژگی های ارائه دهنده Health یک مکان خاص را به روز می کند.

updateServiceList

 لیست خدمات مشخص شده یک مکان را به روز می کند.

verify

 فرآیند تأیید یک مکان را شروع می کند.