تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لتعديل الموقع الجغرافي المحدَّد
لا يُسمح بالصور إلا في موقع له صفحة على Google+.
تعرض NOT_FOUND
إذا لم يكن الموقع الجغرافي متوفّرًا.
طلب HTTP
PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات |
name |
string
اسم الموقع الجغرافي المطلوب تعديله
|
معلمات طلب البحث
المَعلمات |
updateMask |
string (FieldMask format)
الحقول المحدّدة المطلوب تعديلها إذا لم يتم تحديد أي قناع، سيتم التعامل مع هذا الأمر على أنّه تحديث كامل ويتم ضبط جميع الحقول على القيم التي تم تمريرها، والتي قد تتضمّن إلغاء ضبط حقول فارغة في الطلب. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
validateOnly |
boolean
إذا كانت القيمة true، يتم التحقق من صحة الطلب بدون تعديل الموقع الجغرافي فعليًا.
|
attributeMask |
string (FieldMask format)
أرقام تعريف السمات المطلوب تعديلها. سيتم فقط تعديل السمات المذكورة في القناع. إذا كانت إحدى السمات موجودة في القناع وليست في الموقع، فستتم إزالتها. سيؤدي استخدام قناع فارغ إلى تعديل جميع السمات. عند ضبط هذا الحقل، يجب أن يتضمّن updateMask السمات كأحد الحقول المطلوب تعديلها. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يحتوي نص الطلب على مثال Location
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Location
.
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This document outlines how to update a specific Google My Business location using the `PATCH` HTTP request method."],["The request requires specifying the location's name in the URL path and can include optional query parameters like `updateMask`, `validateOnly`, and `attributeMask` to control the update process."],["The request body should contain a `Location` object with the desired updates, and a successful response will return the updated `Location` object."],["Authorization is necessary and requires one of the specified OAuth scopes: `https://www.googleapis.com/auth/plus.business.manage` or `https://www.googleapis.com/auth/business.manage`."],["Photos can only be added to locations with an associated Google+ page, and attempting to update a non-existent location results in a `NOT_FOUND` error."]]],[]]