Class SitesApp

SitesApp

تمت إزالة هذا العمود. تم إيقاف هذا الفئة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

إنشاء "مواقع Google" والوصول إليها

المواقع المتوقّفة نهائيًا

الموقع	Type	الوصف
AttachmentType	AttachmentType
PageType	PageType

الطرق المتوقّفة نهائيًا

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
copySite(domain, name, title, summary, site)	Site	إنشاء موقع جديد من خلال نسخ موقع موجود.
createSite(domain, name, title, summary)	Site	ينشئ موقعًا إلكترونيًا جديدًا.
getActivePage()	Page	يتم عرض الصفحة النشطة في حال استضافة النص البرمجي في حاوية، أو عرض null بطريقة أخرى.
getActiveSite()	Site	يتم عرض الحاوية النشطة، إذا كان النص البرمجي مستضافًا في حاوية، أو عرض null بطريقة أخرى.
getAllSites(domain)	Site[]	استرداد أول 200 موقع إلكتروني ينتمي إلى هذا النطاق
getAllSites(domain, start, max)	Site[]	استرداد جميع المواقع الإلكترونية التي تنتمي إلى هذا النطاق
getPageByUrl(url)	Page	يسترد صفحة باستخدام عنوان URL.
getSite(name)	Site	يسترد "موقعًا إلكترونيًا" لموقع مصمم في "مواقع Google" في حال كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.
getSite(domain, name)	Site	استرداد موقع إلكتروني "لموقع Google" المحدّد.
getSiteByUrl(url)	Site	استرداد موقع إلكتروني من خلال عنوان URL
getSites()	Site[]	يسترد الصفحة الأولى من المواقع لمستخدم، إذا كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.
getSites(start, max)	Site[]	يسترد "مواقع Google" لمستخدم بين الحدود المحددة إذا كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.
getSites(domain)	Site[]	يسترد الصفحة الأولى من المواقع التي تنتمي إلى هذا المستخدم في هذا النطاق.
getSites(domain, start, max)	Site[]	استرداد جميع المواقع الإلكترونية التي تنتمي إلى هذا المستخدم في هذا النطاق للنطاق المحدّد

الطرق المتوقّفة نهائيًا

copySite(domain, name, title, summary, site)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

إنشاء موقع جديد من خلال نسخ موقع موجود.

تحذير: يستغرق نسخ أي موقع إلكتروني وقتًا يتراوح من ثانية إلى عدة دقائق حسب حجم الموقع الإلكتروني. على الرغم من أن الطريقة تعود على الفور، فإن النسخة لا تزال تحدث في الخلفية، ولا تكون كل الصفحات في الموقع المنسوخ متوفرة على الفور. يمكن استخدام هذه الطريقة أيضًا لإنشاء مثيل لموقع إلكتروني جديد استنادًا إلى نموذج معيّن.

// This creates a site. Note that this only works for Google Workspace domains.
// There is no version of this API for consumer accounts.
var site = SitesApp.createSite("examplepetstore.com",
                               "homepage",
                               "My Home Page",
                               "This is a new site I created!");

var siteCopy = SitesApp.copySite("examplepetstore.com",
                                 "homepage-clone",
                                 "Cloned Home Page",
                                 "Begun, these clone wars have.",
                                 site);

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.
name	String	اسم مساحة الويب الموجود في عنوان URL، مثل mySite.
title	String	عنوان الموقع الإلكتروني
summary	String	وصف الموقع الإلكتروني
site	Site	الموقع الإلكتروني المطلوب النسخ منه. وقد يكون موقعًا أو نموذجًا. إذا كانت المَعلمة هي موقع إلكتروني حالي، سيتم نسخ محتوى الموقع الإلكتروني بالكامل. إذا كان الموقع الإلكتروني المحدّد عبارة عن نموذج، سيتم إنشاء موقع إلكتروني جديد استنادًا إلى هذا النموذج.

استرجاع الكرة

Site — الموقع الإلكتروني الذي تم نسخه يُرجى العِلم أنّ النسخة غير متزامنة، وقد تظل عملية النسخ جارية على الرغم من عرض مرجع إلى الموقع الإلكتروني.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

createSite(domain, name, title, summary)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

ينشئ موقعًا إلكترونيًا جديدًا.

// This creates a site. Note that this only works for Google Workspace domains.
// There is no version of this API for consumer accounts.
var site = SitesApp.createSite("examplepetstore.com",
                               "homepage",
                               "My Home Page",
                               "This is a new site I created!");

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.
name	String	اسم المسار الوارد في عنوان URL، مثل mySite.
title	String	تمثّل هذه السمة عنوان الموقع الإلكتروني.
summary	String	تمثّل هذه السمة وصف الموقع الإلكتروني.

استرجاع الكرة

Site — الموقع الإلكتروني الذي تم إنشاؤه

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getActivePage()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يتم عرض الصفحة النشطة في حال استضافة النص البرمجي في حاوية، أو عرض null بطريقة أخرى.

var site = SitesApp.getActivePage();

استرجاع الكرة

Page - الحاوية النشطة إذا كانت صفحة مواقع إلكترونية

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getActiveSite()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يتم عرض الحاوية النشطة، إذا كان النص البرمجي مستضافًا في حاوية، أو عرض null بطريقة أخرى.

var site = SitesApp.getActiveSite();

استرجاع الكرة

Site: الحاوية النشطة إذا كان موقعًا إلكترونيًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getAllSites(domain)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

استرداد أول 200 موقع إلكتروني ينتمي إلى هذا النطاق للحصول على جميع المواقع الإلكترونية، استخدِم طريقة getAllSites(domain, start, max) لتصفُّح النتائج.

// This writes the first page of sites belonging to a Google Workspace
// domain to the log.
var sites = SitesApp.getAllSites("examplepetstore.com.");
for(var i in sites) {
  Logger.log(sites[i].getUrl());
}

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.

استرجاع الكرة

Site[] — مصفوفة من المواقع الإلكترونية التي تنتمي إلى النطاق.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getAllSites(domain, start, max)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

استرداد جميع المواقع الإلكترونية التي تنتمي إلى هذا النطاق

// This writes the a list of sites in domain example.com to the log.
var pageStart = 0;
var pageSize = 50;
while (true) {
  Logger.log("Loading sites starting at %s", pageStart);
  var sites = SitesApp.getAllSites("examplepetstore.com", pageStart, pageSize);
  if (sites.length == 0) {
    break;
  }
  Logger.log("Got %s sites back", sites.length);
  pageStart += sites.length;
  for(var i in sites) {
    Logger.log("Found site: %s", sites[i].getUrl());
  }
}

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.
start	Integer	فهرس الموقع الأول المطلوب عرضه.
max	Integer	تمثّل هذه السمة الحد الأقصى لعدد النتائج المطلوب عرضها.

استرجاع الكرة

Site[] — مصفوفة من المواقع الإلكترونية التي تنتمي إلى النطاق.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getPageByUrl(url)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يسترد صفحة باستخدام عنوان URL.

// This snippet retrieves the page at the given URL.
// Returns null if the page does not exist or if the URL given is invalid.
var page = SitesApp.getPageByUrl(
                    "https://sites.google.com/site/demositeappsscript/mylistpage");
Logger.log(page.getName());

المَعلمات

الاسم	Type	الوصف
url	String	عنوان URL المتاح للجميع.

استرجاع الكرة

Page: مثيل Page مطابق للصفحة المتوفّرة على عنوان URL أو null في حال عدم توفّر الصفحة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSite(name)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يسترد "موقعًا إلكترونيًا" لموقع مصمم في "مواقع Google" في حال كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.

// Returns a Site instance
var site = SitesApp.getSite('mysite');

المَعلمات

الاسم	Type	الوصف
name	String	اسم مساحة الويب الموجود في عنوان URL، مثل mySite.

استرجاع الكرة

Site: مثيل موقع إلكتروني مطابق لموقع إلكتروني مستهلِك.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSite(domain, name)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

استرداد موقع إلكتروني "لموقع Google" المحدّد.

// Returns a Site instance
var site = SitesApp.getSite('example.com', 'mysite');

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.
name	String	اسم مساحة الويب الموجود في عنوان URL، مثل mySite.

استرجاع الكرة

Site — مثيل موقع إلكتروني مطابق لنطاق مستضاف

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSiteByUrl(url)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

استرداد موقع إلكتروني من خلال عنوان URL

// This snippet retrieves the site at the given URL
// Throws an Invalid argument exception if the site does not exist or if
// the URL given is invalid
var site = SitesApp.getSiteByUrl("https://sites.google.com/site/demosite");
Logger.log(site.getName());

المَعلمات

الاسم	Type	الوصف
url	String	عنوان URL المتاح للجميع.

استرجاع الكرة

Site: موقع إلكتروني تم العثور عليه في عنوان URL المحدَّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSites()

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يسترد الصفحة الأولى من المواقع لمستخدم، إذا كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.

// This writes the first page of sites owned by the user running
// the script to the log.
var sites = SitesApp.getSites();
for(var i in sites) {
  Logger.log(sites[i].getUrl());
}

استرجاع الكرة

Site[] — مصفوفة من المواقع الإلكترونية التي يرسلها المستخدم الذي يشغّل النص البرمجي.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSites(start, max)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يسترد "مواقع Google" لمستخدم بين الحدود المحددة إذا كان المستخدم مستهلكًا ليس لديه نطاق مستضاف.

var sites = SitesApp.getSites(25, 50);
for(var i in sites) {
  Logger.log(sites[i].getUrl());
}

المَعلمات

الاسم	Type	الوصف
start	Integer	فهرس الموقع الأول المطلوب عرضه.
max	Integer	تمثّل هذه السمة الحد الأقصى لعدد النتائج المطلوب عرضها.

استرجاع الكرة

Site[] - مصفوفة تضم جميع المواقع الإلكترونية المملوكة لأحد المستخدمين.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSites(domain)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

يسترد الصفحة الأولى من المواقع التي تنتمي إلى هذا المستخدم في هذا النطاق.

// This writes the first page of sites owned by the user running
// the script to the log.
var sites = SitesApp.getSites("example.com");
for(var i in sites) {
  Logger.log(sites[i].getUrl());
}

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.

استرجاع الكرة

Site[] — مصفوفة من المواقع الإلكترونية التي يرسلها المستخدم الذي يشغّل النص البرمجي.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds

---

getSites(domain, start, max)

تمت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في نصوص برمجية جديدة.

استرداد جميع المواقع الإلكترونية التي تنتمي إلى هذا المستخدم في هذا النطاق للنطاق المحدّد

// This writes the a list of sites owned by the user running
// the script in positions bounded by the start and max values to the log.
var sites = SitesApp.getSites("example.com", 25, 50);
for(var i in sites) {
  Logger.log(sites[i].getUrl());
}

المَعلمات

الاسم	Type	الوصف
domain	String	النطاق المستضاف على Google Workspace، مثل examplepetstore.com.
start	Integer	فهرس الموقع الأول المطلوب عرضه.
max	Integer	تمثّل هذه السمة الحد الأقصى لعدد النتائج المطلوب عرضها.

استرجاع الكرة

Site[] - مصفوفة من المواقع الإلكترونية التي تخص المستخدم.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

• https://sites.google.com/feeds